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1 TECHNICAL OVERVIEW OF PORTFOLIO 


The Atari Portfolio is the first product that provides the functionality of a standard 
desktop PC in a package which can fit into a pocket. 

The main requirements for the Portfolio technology are that the product should be 
pocketable, compatible, have low power consumption and above all be inexpensive 
to purchase. 

The Portfolio is the size of a video cassette (VHS) and weighs less than one pound 
(450 grams). 

The Portfolio provides a high degree of software compatibility with the industry 
standard desktop microcomputer, the IBM PC. This is achieved by supplying a PC" 
compatible BIOS, MS-DOS-compatible operating system as welt as Lotus 1-2-3 file- 
compatible spreadsheet. The Portfolio also provides an expansion bus connector 
which allows peripherals to be connected to the product. 

The Portfolio is inexpensive to manufacture as the software is provided on and runs 
from ROM and with the large scale integration of system logic, using an ASIC, the 
overall component cost and size are reduced. 

The Portfolio uses credit card-sized memory cards instead of magnetic disks, and a 
LCD display. These components have a tow power consumption and hence the 
product can use the consumer standard AA batteries and achieve a long battery life. 

This Technical Reference Guide describes the Portfolio technology in detail and 
provides the necessary information for a third party to develop hardware and 
software applications for the Portfolio. This document only provides information 
specific to the Portfolio technology. If you want information on the standard IBM PC 
hardware, BIOS, or MS-DOS then the following publications should provide the 
required information: 


IBM Personal Computer Publications: 

Technical Reference (BIOS and Hardware) 
Disk Operating System (PC-DOS) 


Microsoft Press Publications 


ISBN Reference 


Peter Norton Programmer’s Guide 
The MS-DOS Encyclopedia 
IBM ROM BIOS (Quiok Reference Series) 
MS-DOS Functions (Quick Reference) 


0- 914845-46-2 

1- 55615-049-0 
1-55615-135-7 
1-55615-128-4 
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2 . 


HARDWARE 


2.1. System Description 



BLOCK DIAGRAM OF PORTFOLIO SYSTEM 
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2.1.1 Microprocessor Unit 


The Portfolio uses an 80C88 MPU, the same processor as the original IBM PC. It is 
the CMOS static version which allows the MPU clock to be halted when no 
processing is taking place and hence power consumption is kept to a minimum. The 
Portfolio is faster than the original IBM PC, the clock running at 4.9 152MHz instead 
of 4.77MHz. However, the Portfolio processor uses minimum mode, so bus lock 
cannot be used. (See section 2.6 for more details.) 


2.1.2 System RAM 

The current Portfolio uses four 32 KByte Static RAM chips, giving a total of 
128KBytes. These have a very low standby current which allows them to maintain 
their contents for extended periods with minimal drain on batteries. (See section 2.2 
for more details.) 


2.1.3 System ROM 

The current Portfolio has in total 256 KBytes of ROM which contains all of the BIOS, 
DOS, command processor and application software. This ROM currently comprises 
of two 128 KByte chips. (See section 2.2 for more details.) 


2.1.4 LCD Display 

The LCD is a 240 x 64 pixel display. It is driven by a set of LCD screen drivers which 
are controlled by a graphics LCD controller. The screen behaves in the same way 
as an IBM PC monochrome text screen (MDA). The controller also uses a dedicated 
Video RAM chip and a character generator ROM. For graphics it is pixel compatible 
provided the PC-compatible BIOS is used. (See sections 2.2.2, 2.8 and 3.7.) 


2.1.5 Tone Dialler + Sound 

The Portfolio speaker is driven by a Dual Tone Multiple Frequency (DTMF) 
telephone dialler chip. This produces all the necessary dual tones required for tone 
dialling plus a set of melody tones for musical applications. The keyboard click also 
uses this circuit. (See section 3.3.1.) 
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2.1.6 AS!C 


This circuit contains most of the system logic. (See section 2.4 for more details.) 


2.1.7 Keyboard 

The Portfolio uses a 63-key QWERTY ’switch-matrix’ keyboard. The ASIC 
generates a set of physical scan-codes which are translated by the BIOS to IBM PC- 
compatible scan-codes. 


2.1.8 Memory Card Connector 

The Portfolio contains a memory card connector on the side of the product. Credit 
card-sized memory cards can be inserted into this connector, allowing for data and 
programs to be accessed by the Portfolio software. (See section 2.2.4, 3.6.) 


2.1.9 Expansion Port 

On the right-hand side of the product there is a 60-pin connector which provides the 
necessary signals for various peripherals. (See section 2.6, 2.7 and 3.5.) 


2.1.10 Power Supply Unit 

This supplies all the power required in the system. It produces various supply lines. 
The circuit includes a switching regulator that steps up the voltage from 3 AA cells to 
5V. The regulator may be switched off. (See section 2.5 and 3.8 for more details.) 
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2.2 SYSTEM MEMORY 


2.2.1 Memory Map 



Diagram of Portfolio Memory Map 

(all addresses in hex) 
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2.2.2 RAM 


There is a total of 128 KBytes of on-board RAM provided with the Portfolio. 

4 KBytes of this RAM are mapped to BOOOOh to make up the video RAM which is 
compatible with the IBM PC MDA screen. This gives a total system RAM of 124 
KBytes. 

The system RAM can be expanded up to 636 KBytes by use of memory expansion 
peripheral(s). 

The Portfolio allows the user to have an interna! RAM disk (known as C:) which can 
be user configured. This RAM disk uses the top of the system RAM. 


2.2.3 System ROM A 

This contains the BIOS, operating system and some of the application software. The 
reset vector sits at FFFFOh. This ROM cannot be mapped out of the memory map. 


2.2.4 System ROM B 

This contains the rest of the application software. This ROM may be switched out of 
the memory map and replaced by either the internal memory card or an external 
memory card on a peripheral. The BIOS disk services would normally perform this 
switching function. (See section 3.6.) 
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2.3 Memory Cards 

The Portfolio uses credit card-sized memory cards which are specially designed lor 
the Portfolio. There are similar memory cards available from other vendors. DO 
NOT use these cards with the Portfolio as they may harm the card and the Portfolio. 

These come in three main types: RAM. OTPROM and Mask ROM. (See below for 
explanation.) 

The cards are formatted to look like MS-DOS disks. It is possible to run a program 
directly from a card and hence reduce the amount of system RAM required. (See 
section 3.6.3 for more details.) 


2.3.2 RAM cards 

The RAM cards are currently available in three main sizes; 32, 64 and 128 KBytes. 

The cards are made up of Static RAM and each card contains a lithium back-up 
cell. This cell will maintain the data on a card when it is not in a Portfolio for a year 
or more. 


2.3.3 OTPROM cards 

The One Time Programmable ROMs cards that are currently available are 64 and 
128 KBytes. They are read-only cards and would typically be used for holding fixed 
data or software. They can be programmed in a standard EPROM programmer tike 
a normal PROM (see section 4.4). 


2.3.4 Mask ROM 

These cards are "factory programmed" and have a low unit cost. This makes them 
suitable for issuing mass production software. Currently available only as 128 KByte 
option. 


2.3.5 Future Card Sizes 

The Portfolio BIOS contains support for ROM and RAM cards of greater than 128 
KBytes. If these become available, they will be made up of 128 KByte pages with a 
page register at offset OOOAh. It is imperative that NO application software uses this 
memory card location, no matter what the card capacity. 
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2.3.6 Memory Card Pin-out 


Below is a pin out of typical memory cards. Differences between the various card 
types are highlighted. (Pin 1 is on the right with the connections up and pointing to 


you.) 






Pin 

COMMON 

RAM 

OTPROM 





32k 

64k 

128k 

1 

A16 





2 

A1S 





3 


VBB 

VPP 

NC 

VPP 

4 

A12 





5 

A7 





6 

A6 





7 

A5 





8 

A4 





9 

A3 





10 

A2 





11 

A1 





12 

AO 





13 

DO 





14 

D1 





15 

D2 





16 

GND 





17 

D3 





18 

D4 





19 

D5 





20 

D6 





21 

D7 





22 

CE 





23 

A10 





24 


OE 

OE 

OE/VPP 

25 

All 





26 

A9 





27 

A8 





28 

A13 





29 

A14 





30 


WE 

NC 

NC 


31 

VCC 





32 

CDET 





Notes: 

NC 

No interna! 

connection. 



Mask ROM 


PGM NC 


VCC Operating supply; 5 Volts. 

GND Signal ground 

CDET This is the small pin (internally connected 
to GND), used to detect presence ot card. 

Ax Card address line x. 

Dx Card data line x. 

VBB Card battery voltage. 

PGM OTPROM program line. OV in program mode. 
VPP OTPROM program voltage. 

12.5V Program mode, 5V normally 
OE Low to indicate a read cycle. 

WE Low to indicate a write cycle. 
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2.4 Custom ASIC Chip 


The Portfolio custom ASIC chip provides most of the necessary system logic, it is a 
gate array implemented using silicon gate CMOS technology, which allows for very 
low power and high speed operation. 

This Application Specific integrated Circuit (ASIC) is used to generate all the select 
lines for the memory, memory cards and other system blocks. It also contains 
several system control functions. These functions are controlled using a set of 
registers which control the various parts of the system such as memory chip size. 


2.4.1 System Clock 

The clock is 4.9152MHz, with a 50% duty cycle produced by a crystal oscillator. The 
clock can go in to a stop mode. A custom chip interrupt will cause the clock to 
restart. 


2.4.2 Timer 

The system timer tick count is generated from a 32768Hz crystal oscillator which will 
generate an interrupt every 1 second or every 128 seconds. 


2.4.3 Keyboard Controller 

The keyboard controller will scan an eight by eight push to make key-switch matrix. 
A pressed or released key will cause an interrupt. The processor will obtain the scan 
code from a control register. 


2.4.4 Interrupt Handler 

This controls the critical error for the memory oards, keyboard and tick count 
interrupt. This is extended outside the ASIC to allow for external peripheral 
interrupts. 


2.4.5 Soft Contrast for LCD 

A control register holds the contrast value for the LCD display. 
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2.5 Power Supply Unit 

The Portfolio has several pov/er supply lines and control lines. These are used for 
various purposes and have different power characteristics as explained below. They 
are all available on the expansion bus. 

When batteries and a power supply are connected to the Portfolio simultaneously, 
the Portfolio will be supplied by the higher voltage ("initial source"). 

(See section 3.8 for software issues.) 


2.5.1 Power Modes 

0 NO POWER MODE 

This is the state when no initial source is connected to the Portfolio (e.g. changing 
batteries). If an initial source has been supplied and then removed, the system RAM 
will be backed up by an internal capacitor. 

ii) OFF MODE 

This is the state the Portfolio goes into when the 'OFF' command is used. The 
custom chip and RAM are powered directly from the initial source. 

Hi) STANDBY MODE 

This is the state that the Portfolio will be in while waiting for a key press. The whole 
system is powered from the output of the internal five volt regulator. However, the 
system clock CCLK Is halted in order to stop the processor and save power. 

iv) RUN MODE 

This the state in which the Portfolio is actually processing. The whole system is 
powered from the output of the five volt regulator and the system clock CCLK is 
running, thus causing maximum power usage. 


2.5.3 VCC (Memory Card supply voltage) 

This line follows 5VS. It is designed to be used by an external memory card so that 
plugging in and pulling out a card will not cause spikes on 5VS. This tine should not 
be used for any other purpose. 
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2.5.2 5VS - Five Volt switched supply line 

This is the output of the five volt regulator. During STANDBY and RUN modes, this 
line will supply five volts. At any other time this line will float tow. Peripherals may be 
designed that use this supply. 

5VS is capable of supplying up to 40 mA at 5V +/- 5% to a peripheral. This assumes 
that the main unit is taking maximum power. The Portfolio will run correctly outside 
the 5% supply tolerance: however, this is not recommended. 

Use of 5VS by a peripheral will decrease the unit’s battery life. Also, since alkaline 
batteries develop a voltage drop (due to internal resistance) the low battery warning 
will occur when the batteries are less depleted than if the peripheral was not 
plugged in. 


2.5.4 VRAM (Memory Power Supply) 

This is the supply for the system RAM: 

STANDBY and RUN 4.5V 

OFF initial source voltage - 0.5V 

NO POWER current voltage across a capacitor. 

During NO POWER Mode the voltage will decay, so care should be taken that no 
current is taken from this line or the system RAM could be corrupted. When the cold 
reset switch is pressed this line is pulled to GND through a small resistor. 


2.5.5 VEXT (External voltage) 

This is the external power supply voltage connected directly to the external jack 
socket. This enables peripherals with their own power source to make use of the 
Portfolio external power supply. It is possible to supply the Portfolio via this 
connection. However, care should be taken to avoid external power supply conflicts. 


2.5.6 BATD (Battery detection signal) 

This control signal is used to isolate system RAM from the rest of the circuit when 
the batteries are removed. It would normally carry the Initial source but when the 
initial source is removed, it is pulled to GND. This line could be used by a peripheral 
to access the initial source. 
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2.6 Portfolio Expansion Port 

The Portfolio uses a 60-pin expansion connector which can take custom designed 
peripherals. (See section 4 for more details on current range of peripherals.) 


2.6.1 Expansion Port Connector Pin-out 

Location of pin 1 - If you are looking into the Portfolio expansion port then the top 
pin on the right is 1 and the bottom right is 2. 


ABUF 

. 1 

2. 

5VS 

REDY 

. 3 

4. 

VCC 

BCOM 

. 5 

6 . 

NCC1 

NMD1 

. 7 

8. 

WAKE 

DTR 

. 9 

10 . 

DEN 

PDET 

.11 

12 . 

lINT 

CCLK 

.13 

14. 

MRST 

HLDA 

.15 

16. 

HLDO 

lACK 

.17 

18. 

CDET 

lOM 

.19 

20. 

A19 

A18 

.21 

22. 

A17 

A16 

.23 

24. 

A15 

A14 

.25 

26. 

A13 

A12 

.27 

28. 

All 

AID 

.29 

30. 

A9 

A8 

.31 

32. 

VRAM 

HLDI 

.33 

34. 

ALE 

GND 

.35 

36. 

NMIO 

OA7 

.37 

38. 

OA6 

OA5 

.39 

40. 

OA4 

OA3 

.41 

42. 

OA2 

OA1 

.43 

44. 

OAO 

ADO 

.45 

46. 

ADI 

ADZ 

.47 

48. 

AD3 

AD4 

.49 

50. 

AD5 

AD6 

.51 

52. 

AD7 

EINT 

.53 

54. 

NRDI 

VEXT 

.55 

56. 

EACK 

BATD 

.57 

58. 

NWRI 

5VS 

.59 

60. 

SBUF 
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2.6.2 Explanation of expansion pin names 

This section explains the functions of the expansion port. It assumes a knowledge of 
80C88 minimum mode. Detailed Timing for relevant signals can be found in a 
microprocessor data sheet, ideally OKI MSM80C88ARS-2. 

REDY output 

This line indicates to the CPU that the custom chip is ready. This line is 
active high. 

VCC output 

This is the Credit Card power supply. 

BCOM output 

This is the communications select line, used for peripheral 
implementations, it is low if I/O locations 807X are being accessed. This 
signal is active within lOOnS of I/O address being valid (see section 2.7). 

NCC1 output 

This is the external credit card chip select line. It is low if the external 
credit card is selected. See BCOM for timing. 

NMD1 input 

This is the external credit card detect line, it goes low to indicate that a 
card is plugged in. 

DTR input/output 

This is the 80C88 data direction signal. During CPU HOLD this line may 
be driven. 

DEN input/output 

This is the 80C88 data enable signal. Low indicates a data cycle. During 
CPU HOLD this line may be driven. 

PDET input 

This is the peripheral detection line. It should be tied high on a terminating 
peripheral that has a PID. (See section 2.7 for more details.) 

IINT output 

This is the internal interrupt request line to the CPU (INTR). It goes high to 
indicate an interrupt request. 
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lACK input/output 

This is the 80C88 interrupt acknowledge line (INTA). It goes low to 
request an interrupt vector after an lINT. During CPU HOLD it may be 
driven by external hardware. 

El NT input 

This is the external interrupt request line. It may be driven high by externa! 
hardware on a terminating peripheral to request an interrupt. This interrupt 
line has lower priority than the on board interrupts. This signal is level 
triggered. 

BACK output 

This is the external interrupt acknowledge line from the Portfolio. It goes 
low to request an interrupt vector after an EINT. It follows \INTA on the 
processor, but is delayed by up to 40nS. 

CCLK output 

This is the main processor dock (4.9152MHz, 50% duty cycle). Since the 
clock pauses when no processing is taking place, dynamic logic should 
not use this line. It may be used for synchronising peripheral logic. During 
halt mode this line is high. This signal is only available to terminating 
peripherals. 

MRST output 

This indicates system reset. MRST will normally be high, except when a 
terminating peripheral is installed. The terminating peripheral will experi 
ence a short reset when inserted. If a terminating peripheral is installed 
then MRST goes high to indicate system reset. MRST will remain high at 
any time the reset key is pressed. It will also go high when the main 
computer system powers up. Under these conditions MRST will remain 
high for over 300mS. 

HLDI input 

This is the hold request line and will drive HOLD on the 88C88. It may be 
driven high by external hardware to requisition the system bus. 

HLDO output 

This is the 80C88 hold request line (HOLD). HLDI should be used to 
request a HOLD. 

HLDA output 

This is the 80C88 hold acknowledge line (HLDA). It goes high to indicate 
that the bus is now free. This state will be called CPU HOLD. 
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WAKE input 


This line is used by a peripheral to wake up the main computer when it is 
powered down. This line is set low to request wake up. Wake up can be 
confirmed by waiting for a falling edge on MRST. It will take 300-400mS 
for wake-up to be confirmed. When wake up is confirmed, the wake input 
should be released. 

CDET input 

This signal is tied low to indicate to the main computer that an external 
credit card drive is present. 

tOM input/output 

This is the 80C88 memory access select line, if high then a I/O cycle is 
taking place, if low then a memory cycle. During CPU hold this line may 
be driven. 


VRAM output 

This is the RAM power supply. It will backup RAM when the batteries are 
removed, therefore any current taken from this line should be pAs. 

5VS output 

This is the switched 5V output. There are two 5VS lines. 

GND output 

Signal ground line. 

VEXT output 

This is the external power supply line. 

ALE input/output 

This is the address latch signal from the CPU. It latches the address bus 
on its falling edge. During CPU HOLD this line may be driven. 

A8-A19 input/output 

These are the upper part of the address bus from the CPU. During CPU 
HOLD these lines may be driven. 

AD0-AD7 input/output 

These are the multiplexed address/data bus from the CPU. During CPU 
HOLD these lines may be driven. 

OAO-OA7 output 

These are the lower latched address lines. 
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NRDI input/output 

This is the 80C88 \RD signal. It goes low to indicate a CPU read cycle. 
During CPU HOLD this line may be driven. 

NWRl input/output 

This is the 80C88 \WR signal. It goes low to indicate a CPU write cycle. 
During CPU HOLD this line may be driven. 

BATD output 

This is the detect line for the batteries. It goes low if the batteries are 
removed without a power supply being present. This can be used to 
prevent accidental corruption of RAM. 

ABUF/BBUF input 

These are insertion detection pins. A terminating peripheral should have 
these lines connected to the adjacent 5VS line. (See section 2.7 on 
peripheral design.) 

NMIO output 

This is the 80C88 non-maskable interrupt request line. 

2.6.3 Comparison between IBM and Portfolio expansion bus 


The IBM PC and Portfolio expansion buses are analogous; however, the 
implementation of these buses are very different. See the comparison below: 


IBM PC 

a) I/O is partially decoded. 

b) AO-A 19 are latched address 

c) D0-D7 are buffered data 

d) IRQ2-IR07 are inputs to 
the interrupt controller. 

e) lOR/IOW/MEMR/MEMW are 
MAX mode bus control signals 

f) DRO1-DRO3/DACK0-DACK3/AEN/TC 
are DMA control signals 

g) I/O CH RDY inserts wait 
states for slow I/O. 

h) ALE is address latch enable. 

1} OSC Is 1 4.3 1 8 1 8 MHz Clock. 

j) CLK is 4.77 MHz, 33% duty 
cycle clock 

k) lOCHCK 


Portfolio 

I/O MUST be fuliy decoded. 

OAO-OA7 are iatched address A8-A19 are 
address lines DIRECT from the processor. 

AD0-AD7 are multiplexed address/data lines 
DIRECT from the processor. 

EINT/EACK allow connection of peripheral 
with an interrupt controller. 

NRDI/NWRI/IOM are MIN mode bus control 
signals. 

No analogous signals, however, enough control 
signals exist to allow DMA control on a peripheral. 

No analogous signal. 

ALE is address latch enable 
No equivalent signal. 

CCLK is 4.9152 MHz, 50% duty clock which halts. 
No signal. 
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TYPICAL TERMINATING PERIPHERAL 



NCC1 EXPANSION 

► 

ROM 


GND 


EXPANSION BUS 
< TOWARDS PORTFOLIO) 
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2.7 PERIPHERAL DESIGN ISSUES 


There are two types o( peripheral that can be connected to the Portfolio. These 
peripherals either continue the system bus ("Through Peripheral") or not 
("Terminating Peripheral"). Different considerations are required for designing these 
types of peripherals. Appendix C illustrates an example peripheral design. (See 
section 3.5 for software issues.) 


2.7.1 Terminating Peripherals (see diagram) 

A peripheral of this type signals its presence to the Portfoiio by having PDET tied 
high. If PDET is high then the Portfolio expects to see a Peripheral Identifier(PID). 
This is read from I/O location 807Fh. The returned number must be in the range 
40h-7Fh. Please note that identifiers under 40h and over 7Fh are reserved for use 
by DIP and must NOT be used by non-DIP applications. 

A read at I/O location 807Fh should NOT be used by any peripheral in ANY way 
other than as stated above. 

A terminating peripheral can have an expansion ROM which contains support 
software for the peripheral, This eliminates need for software to be supplied 
separately. The chip select for this ROM should be connected to NCC1 . At various 
times during a boot sequence, the ROM will be checked for an identifier. If this is 
present then the software contained on the ROM will be executed. (See section 3.5 
for more details.) 

The Portfolio has only limited expansion bus buffering. To make best use of this the 
following rules should be obeyed. 

i) ABUF and BBUF should be tied to the adjacent 5VS lines. This wilt cause the 
processor to hold while a connector is half in. 

ii) Only OAO-OA3 should be used. BOOM should be used for higher addressing on 
peripherals. 

iii) Peripherals using the external interrupt facility should be reset by MRST into a 
state where interrupts are disabled until the vectors are set up correctly. This is to 
prevent spurious interrupts occurring before the interrupt vector is set up. 
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TYPICAL THROUGH PERIPHERAL 

BBUF 


ABUF 



EXPANSION BUS 
(TOWARDS PORTFOLIO) 


EXPANSION BUS 
(AWAY FROM PORTFOLIO) 
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2.7.2 Through peripherals (see diagram) 

On these peripherals the system bus is continued so that further peripherals can be 
connected to the system. For example, a memory expansion unit would be this type 
of peripheral. In order that terminating peripherals will operate correctly the following 
recommendations should be taken into account when designing "through" 
peripherals. 

i) ABUF and BBUF should not be connected to 5VS, but brought straight through 
the peripheral. 

ii) If OAO-OA3 are used on the peripheral, they should be buffered before the 
"through" connector. 

iii) PDET should not be connected to 5VS, but brought straight through the 
peripheral. 

iv) The I/O locations 8070-807F should not be used so as to provide compatibility 
with terminating peripherals using these locations (such as DIP serial and parallel 
peripherals). 807Ch can be used as stated in vi) below. 

v) "Through" peripherals risk crashing the system bus as virtually no buffering exists. 
It is therefore recommended that these peripherals are only inserted or removed 
from the Portfolio when powered down. 

vi) To ensure that ROM extensions on terminating peripherals function correctly, 
through peripherals which contain a memory card interface must supply logic that 
follows the following rules: 

* A write of zero to I/O 807Ch wilt cause NCC1 to be directed to the through 
expansion port. 

* A write of one to I/O 807Ch will cause NCC1 to be directed to the peripheral 
memory card interface. 
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2.7.3 Allocation of Peripheral ID (PID) bytes 

The PIDs have currently been allocated as follows: 


PID 

PERIPHERAL 

OOh 

01h 

02h 

03h 

04h 

05-3Fh 

40-7Fh 

80h 

81-FFh 

Communication Card 

Serial Port 

Parallel Port 

Printer Peripheral 

Modem 

Reserved 

User Peripherals 

File-Transfer Interface 

Reserved 


For custom user peripherals a specific PID can be allocated by contacting the Atari 
Portfolio Product Manager in writing, describing the use of the peripheral. 
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2.8 LCD Display 

The Portfolio uses a 240x64 pixel LCD display which uses the "Super-twist” 
technology. This corresponds to 8 lines of 40 characters text display. 

The circuit includes a graphics LCD screen controller with dedicated screen RAM 
chip and character set ROM, used in such a way as to be compatible as possible 
with an IBM Monochrome Display Adapter (MDA). (See section 3.7 for more 
details.) 

The LCD circuit has the following characteristics: 

* Full IBM PC Extended character set (see Appendix B) 

* Virtual 80x25 MDA screen page with various screen modes 

* PC-BIOS compatible pixel Set/Reset for graphics 

* Each character is implemented as an array of 6x8 pixels 

* Software controlled contrast 

* Block or underline cursor 

Note: Screen text attributes and various cursor modes are not supported by the 
Portfolio. 


2-21 


3 SOFTWARE 


3.1 General Description 

3.1.1 Overview 

The Atari Portfolio software is contained on ROM and predominantly executes from 
ROM, and hence minimizes the use of RAM. This software provides as much PC 
compatibility as possible given the hardware constraints. (See sections 3.2 and 3.4 
for BIOS and DOS comparisons.) 

This software also includes some more advanced features which enable the 
Portfolio to be used more effectively in a portable environment than a standard PC. 
Most of these software features are accessed using Interrupt 61H, the Atari Portfolio 
specific functions. (See section 3.3.1.) 

To aid development of application software for the Atari Portfolio which require the 
use of these specific functions there is a TSR (Terminate and Stay Resident) 
Emulator program for the IBM PC. This program emulates most of the functions. 
(See section 3.10 for more information.) 


3.1.2 Portfolio Programming 

The Portfolio obeys IBM’s own programming guidelines for PC compatibility, 
however these are a lot more flexible than the industry-standard definition of a 
’clone’ PC. 

Most ’well-behaved’ PC programs run with no problem on the Portfolio, provided 
that they do not go below the BIOS to directly use the hardware. The main 
development issues are the screen size and memory capacity. Below are the 
various points to take into consideration when developing a program for the 
Portfolio. 

SCREEN - (See also section 3.7.) 

The Portfolio has a 40 column by 8 line text display which uses video RAM at the 
same address as the PC Monochrome Display Adaptor (MDA) and uses the same 
character set. However the Portfolio LCD controller does not support text attributes 
such as bold, underline and reverse or the various cursor sizes. If you want to use 
the Portfolio graphics facility then use the standard BIOS pixel read and write 
interrupt. 
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MEMORY - (See also section 2 . 2 .) 

The Portfolio has an internal memory disk C: which can be configured in 8KB 
intervals, minimum 8KB, This leaves a maximum of 1 16 KByte usable RAM of which 
10 KBytes are used by the operating system and BIOS. Therefore it is recommended 
that programs should not use more than lOOKBytes of system RAM. if you want to 
use the built-in ’pop-up’ applications with the external program then allow for some 
free RAM (minimum of 17 KBytes). 

MEMORY CARDS - (See also section 3.6.) 

These memory cards appear to a DOS program like a standard floppy disk. The 
Portfolio has DOS resident all of the time and therefore does not need to boot from 
a disk. If you want to automatically boot into a program then you can put 
AUTOEXEC.BAT on a memory card, overriding C:\AUTOEXEC. 

RS232/SERIAL - (See also section 4.1.) 

The only compatible method for accessing the serial port is through the BIOS. 
However most off-the-shelf serial programs go directly to the hardware. 

KEYBOARD- (See also section 3.2. 1 .) 

The Atari Portfolio supplies full IBM PC scan-code compatibility provided access is 
through the BIOS. In other words it is possible to generate every keypress or 
combination that a standard PC can generate (SHIFT, CTRL. ALT, NUM PAD), it is 
also possible to generate other non-PC key combinations necessary for functions 
such as contrast and switching off. 

POWER - (See also section 3.8.) 

For power conservation, it is recommended that programs are designed which do 
not poll the keyboard continuously. 

ADVANCED 

There are also more advanced features which enable custom programs for the 
Portfolio to perform more sophisticated tasks, such as running programs directly 
from the memory cards (section 3.6), peripherals with built-in software on ROM 
(section 3.5), language Information and access to the built-in tone dialler. 
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3.1.3 Troubleshooting 

Running well-behaved standard off-the-shelf PC Programs: 

* Make sure that the DISPLAY SETUP (see user manual) is set to Static PC for 
External programs. 

* If the program writes directly to Video RAM then ensure that DISPLAY REFRESH 
is set to KEYBOARD or FAST TIMED, whichever is more appropriate. 

* Endeavor to allocate enough system RAM. 

Although many popular programs are ’well-behaved’ there are also many programs 
which directly address the hardware. This can cause a problem on the Portfolio as 
the 10 addresses are different. The most common of these incompatibilies occur 
with the keyboard and hardware interrupts, The Portfolio does not have a 
Programmable Interrupt Controller (PIC) or a dedicated keyboard controller, 
therefore some programs which access these such as Basic and XTALK wilt not 
function correctly. The Portfolio also uses a different Timer Tick than a PC which 
affects some ’dirty’ programs such as Sidekick. Another hardware area that differs 
on the Portfolio is the use of the speaker, which should be accessed using the 
BIOS. 
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3.2 Differences Between Portfolio BIOS and IBM PC BIOS 

For the purposes of this document, Portfolio BIOS is defined as the program which 
communicates between the DOS and the hardware. (See recommended books in 
section 1 for more information on the standard PC BIOS.) 

There are a few differences between Portfolio BIOS and the standard IBM PC 
BIOS. These are generally in areas where the hardware differs to such an extent 
that complete compatibility is unobtainable. For example, in the Video Services (Int 
10H) the Portfolio only has two screen modes; 80 by 25 Text and 240 by 64 
Graphics. 


3.2.1 Interrupt differences 

The following list highlights the main differences between the DIP BIOS and IBM PC 
BIOS: 

Int 09H Keyboard 

The Portfolio keyboard is not at the same 10 address as a standard IBM 
PC, therefore any program which requires fhe keyboard to be at port 60H 
will not work correctly. 

Int 10H Video Services 

Service OOH, Mode 07 to OAH are supported, but only in Text or Graphics 
mode, Service 01 H, Cursor size is set to either block or u/line. (See 
section 3.7.) 

lnt13H Disk 

The Portfolio has modified Memory Card/Disk services 0 to 05H and 83H. 
(See section 3.3.2 for more details.) 

Int 15H Extended 

No Extended services are available. 

int 16H Keyboard 

Only service 0, 1, 2, 4 are supported. 

Int 18H BASIC 

Not supported. 

Int 1AH Clock 

Only services 0-07H supported. 

int 1CH Timer tick 

Invoked less frequently than IBM PC (see section 3.3.1). 


3-4 


3.2.2 Portfolio BOOT procedure 


On a COLD boot (batteries removed, COLD Reset switch pressed, then batteries 
replaced), the BIOS executes a limited Power On Self Test (POST) to verify system 
integrity. This will destroy data in system memory (both programs in the Transient 
Program Area and those on internal drive C;). The Portfolio system then performs 
BIOS and DOS initialization before jumping to the COMMAND processor. This will 
always reset the machine unless there is a hardware fault. 

On a Hardware WARM boot (WARM Reset switch pressed or batteries replaced 
without pressing the COLD Restart switch), the Portfolio performs BIOS and DOS 
initialization before jumping to the COMMAND processor. 

On a Software WARM boot (Ctrl-Alt-Del on keyboard), the sequence of operations 
is similar to those for a Hardware warm boot. The difference between the two is that 
a Hardware warm boot also resets the ASIC and Processor which may be 
necessary if the interrupts have been disabled because the keyboard will not 
recognize user key presses. 
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3.3 System Specific BIOS 

3.3.1 Int 61H - DIP extended BIOS services 


Function 

Description 

OH 

7H 

8H 

9H 

BH 

DH 

EH 

FH 

10H 

11H 

12H 

15H 

16H 

17H 

18H 

19H 

1AH 

1BH 

1CH 

1EH 

1FH 

20H 

24H 

26H 

28H 

2CH 

2DH 

2EH 

30H 

Service initialization 

Format Credit Card Memory (CCM) 

Get size of internal disk 

Format Internal disk 

Determine if CCM present 

Get Screen size 

Get/Set Screen mode 

Get/Set Cursor mode 

Get/Set virtual screen position 

Move virtual screen position 

Screen refresh 

Sound generation 

Melody tone 

Dial number 

Mute states 

Get Serial port parameters 
Get Peripheral ID byte 
Set Peripheral ID byte 
Preset Peripheral lO data 
Get/Set Clock tick speed 
Get-key/Tick Screen refresh 
Disable revectoring of Int 9H 
Get/Set ROM space state 
Get/Set Power State 
Get/Set Language 
Get BIOS version number 
Turn system off 
Enable/Disable status line 
File transfer via smart cable 


Note: There are other reserved Int 61 H services v/hich are used internally by the 
Operating system. It is not recommended that these services are invoked by 
applications software, as they may be modified or deleted in future versions of the 
software. 
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Fn OOH Service Initialization 


3.10 


Parameters: 

AH OOH 

Returns: 

None 

Note: This service should be called once only as part of Its initialization by any 
application program that intends to use any Int 61H function calls. 

Fn 07H Format Credit Card Memory 2.3, 3.6, 3.32 

Parameters: 

AH 07H 

AL Drive number (0 or 1) 

Returns: 

CF Set if error during format 

AH Error code (See INT 13H) 

Note: Drive number 0 selects drive A:, and drive number 1 selects drive B:. This 
service should not be used to format the internal disk (drive number 2). 


Fn OSH Get size of Internal disk 3.3.2 

Parameters: 

AH OSH 

Returns: 

AX Segment Address of disk 

BX Size of disk in Kbytes 


Fn 09H Format Internal disk 3.3.2 

Parameters: 

AH 09H 

BX Size of disk in Kbytes 

Returns: 

If CF=1 

BX Maximum size possible (K) 

Note: The system is rebooted if successful. All files on drive C: will be tost. 
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Fn OBH Determine if CCM present and valid 2.3, 3.3.2, 3.6 


Parameters: 

AH 

AL 

Returns: 

OBH 

Drive number (0 or 1) 

CF=0 

Card present and correct 

If CF=1 
AH 

Error code (See Int 13H) 


Note: This can be used to determine if a valid CCM is in the specified drive. Drive 
number 0 selects drive A:, and drive number 1 selects physical drive B:. 

Fn ODH Get screen size 2.8, 3.7, 2.1.4 


Parameters: 

AH 

Returns; 

ODH 

AX 

DX 

Physical screen size 
Logical screen size 

Note; 

AH/DH 

AL/DL 

Row number 
Column number 


Fn OEH Get/Set screen mode 2.1.4, 2.8, 3.7 


Parameters: 

AH 

AL=Q 

AL=1 

DL 

Returns; 

If AL=0 

OEH 

Get mode 
Set mode 
New mode 

DL 

If AL=1 

Mode 

DL 

Old mode 
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Note: The mode is changed by setting one of the following mode bits in DL: 


Clear bits (00H)80 by 25 mode 
bit 0 (01H) 40 by 8 mode 
bit 1 (02H) Tracked mode 
bit 7 (80H) Graphics 

These bits are mutually exclusive, When changing to 40 by 8 mode, if the 
cursor position or virtual screen origin is off the screen, then the virtual 
screen origin will be set to (0.0), the Screen cleared and cursor homed. 


Fn OFH Get/Set Cursor mode 

Parameters: 

AH OFH 

AL=0 Get mode 

AL=1 Set mode 

BL New Cursor mode 

AL=2 Force mode 

Returns: If AL= 0 

BL Cursor mode 
If AL> 0 

BL Old Cursor mode 

Note: Cursor mode is as follows: 

0 Cursor off 

1 Underline 

2 Block 


2 . 1 . 4 . 2 . 8 . 3.7 


Force mode automatically sets the BIOS cursor size to reflect the Keyboard 
Numlock state. 
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Fn 10H Get/Set virtual screen position 


2.1.4. 2.8. 3.7 


Parameters: 

AH 

AL 

AL 

If AL=1 

DH 

DL 

Returns: 

If AL=0 

DH 

DL 


10H 

0 Get position 

1 Set position 

Row number 
Column number 


Row number 
Column number 


Note: The virtual screen position is the top left origin of the 40 by 8 window on the 
logical screen. 


Fn 11H Move virtual screen position 2.1.4. 3.7 

Parameters: 


AH 

11H 


AL 

Number of lines to move cursor 

DL 

Direction to move cursor 


1 

Up 


2 

Down 


3 

Left 


4 

Right 


Returns: 

None 

Note: This moves the origin of the virtual screen within scroll margins. It only works 
if in Static or tracked mode, and has a similar effect to pressing the Alt- 
Cursor keys. 


Fn 12H Screen refresh 2.1.4, 2.8, 3.7 

Parameters: 

AH 12H 
Returns: None 

Note: This service copies the contents of the Video RAM to the LCD controller, 
and Is slightly faster than invoking Int 10H service 0. 
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Fn 15H Sound generation 


2.1.5 


Parameters: 

AH 15H 

AL Sub service; 

0 Key-dick 

1 Beep 

2 Alarm 

Returns; 

None 


Fn 16H Melody tone generator 


2.1.5 


Parameters: 

AH 16H 

CX Length of tone in 10 mSecs intervals 

DL Tone code (See below) 


30H 

D«5 

622.3 Hz 

31H 

E5 

659.3 Hz 

32H 

F5 

698.5 Hz 

33H 

F»5 

740,0 Hz 

34H 

G5 

784.0 Hz 

35H 

G*5 

830.6 Hz 

36H 

AS 

880.0 Hz 

37H 

A«5 

932.3 Hz 

38H 

B5 

987.8 Hz 

39H 

C6 

1046.5 Hz 

3AH 

C#6 

1108.7 Hz 

29H 

D6 

1174.7 Hz 

3BH 

D«6 

1244.5 Hz 

3CH 

E6 

1318.5 Hz 

3DH 

F6 

1396.9 Hz 

OEH 

F#6 

1480.0 Hz 

3EH 

G6 

1568.0 Hz 

2CH 

G#6 

1661.2 Hz 

3FH 

A6 

1760.0 Hz 

04H 

A»6 

1864.7 Hz 

OSH 

B6 

1975.5 Hz 

25H 

C7 

2093.0 Hz 

2FH 

C»7 

2217.5 Hz 

06H 

D7 

2349,3 Hz 

07H 

D«7 

2489,0 Hz 


Returns: 

None 
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Fn 17H Dial number 


2.1.5 


Parameters: 

AH 17H 

DS;SI String of characters 
CX Length of string 

Returns: 

None 

Note: String to be in ASCII. Valid characters are: 01 23456789ABCD**^. 
Letters must be in upper case. 


Fn 18H Mute states 

Parameters: 

AH 18H 

AL 00 

01 
02 

03 

04 

05 

06 

07 

08 
09 


Get mute state 
Set mute state 
Get key click state 
Set key click state 
Get bleep state 
Set bleep state 
Get alarm state 
Set alarm state 
Get DTMF duration 
Set DTMF duration 

1, 3, 5, 7 or 9 

0 Off (Muted) 

1 On 

0. 2, 4. 6 or 8 

0 Off (Muted) 

1 On 


If AL = 
DL 

Returns: 

If AL = 
DL 
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Fn 19H Get Serial port parameters 


2.7, 4.1. 3.5 


19H 

Serial port number 


Parameters: 

AH 
DX 
Returns: 

If AH=0, Composite parameters in AL 
If AHoO, Error 

Note: This service returns composite parameters identical to those used by Int 14H 
Service 0 (Initialize). 
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Fn 1AH Gel Peripheral ID byte 


2.7. 3.5 


Parameters: 

None 

Returns: 

AH Peripheral ID byte 

AL 0 if no peripheral installed 

Note: This returns the peripheral ID code for the current terminating peripheral. 
(See Fn 1BH.) 


Fn 1BH Set Peripheral ID byte 

Parameters: 


AH 

1BH 

AL=0 

Set Serial ID 

AL=1 

Set Parallel ID 

DL 

Current peripheral ID 


Returns: 

None 


Note: There may be peripherals designed that contain circuitry that is similar to the 
Serial or Parallel peripherals. In order that these peripherals may use existing 
BIOS services they must identify themselves as being software compatible. 
DL should be set to the Peripheral ID code. (See Fn 1AH.) 


Fn 1CH Preset/Return Peripheral data 2.7, 3.5. 4.1 

Parameters: 

AH 1CH 

AL=0 Preset Data values 

AL=1 Return Data values 

BH Table entry number 

If AL=0 

BL Data value 

DX lO address 

Returns: 

If AL=1 

BL Data value 

DX lO address 
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Note; This service is used to preset peripheral 10 data in a table associating an lO 
address with a data value. Service 0 will actually output the data to the 
specified 10 locations. On Power-up, the table entries will be scanned for 
non-zero 10 address values, and the associated data will be written out, This 
would typically be used to restore Interrupt numbers following Power-up. The 
first four table entries out of 10 max are reserved. 


Fn 1EH Gel/Set Clock tick speed 2.4. 3.8 

Parameters: 

AH 1EH 

AL Subservice 

0 Get speed 

1 Set speed 

If AL = 1 

BX Clock tick speed 

0 Tick every 128 seconds 

1 Tick every second 

Returns: 

If AL = 0 

BX Clock tick speed 

0 Tick every 128 seconds 

1 Tick every second 

Note: 1 sec speed uses much more power. 
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Fn 1FH Get-Key/NMI invoked screen refresh 


2.8. 3.7. 3.8 


Parameters; 

AH 

AL=0 

AL=1 

1FH 

Get refresh state 
Set refresh state 

If AL=1 
DX 

New state 


Returns; 

If AL=0 

DX Current state 


If AL=1 
DX 

Old state 

Note; 

DH 

DL 

Refresh on NMIs state 
Refresh on keys state 


DH/DL=0 Revectoring disabled 
DH/DL=1 Revectoring enabled 

If bit 7 of the state is set, then the state is unchanged, 

Fn 20H Disable revectoring of Int 9H 3.2 


Parameters: 

AH 

AL=0 

AL=1 

20H 

Get revectoring of Int 9H state 
Set revectoring of Int 9H state 

If AL=1 

DL=0 

DL=1 

Disable revectoring 
Enable revectoring 


Returns; 

If AL=0 

01=^0 Revectoring disabled 

DL=1 Revectoring enabled 

Note; This is used to automatically revector Int 9H to the BIOS. This prevents 

applications software from setting up its own Int 9H. Note that the Portfolio 
keyboard 10 address is not IBM compatible. This service is automatically 
invoked on a boot. 
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Fn 24H Get/Set ROM/CCM space state 


2.2.4 


Parameters: 

AH 24H 

AL=0 Get ROM state 

AL-1 Set ROM state 

It AL=1 

DL New ROM state 

DH New COM state 

Returns: 

If AL=0 

DL Current ROM state 

DH Current CCM state 

If AL=1 

DL Old ROM state 

DH Old CCM state 


Note: ROM state in DL is as follows: 

DL=0 Normal applications ROM 
DL=1 CCM Drive A: 

DL=2 CCM Drive B: 

DL=3 Expansion ROM 

CCM state in DH is as follows: 

DH=0 CCM Drives Disable(d) 

DH=1 CCM Drive A: Permanently enable(d) 

DH=2 CCM Drive B: Permanently enable(d) 

CF=0 No error 

CF=1 Invalid option or error 

Note: This service should be used with care, as it can swap either Memory cards 
or an extension ROM into the C000;0 to 0DFFF:F address range. This range 
is normally used by the internal applications ROM, Its primary use is to allow 
advanced users direct access to extension ROMs and Memory cards. 


3-16 


Fn 26H Get/Set Power control 


2.1.10. 2.5, 3.8 


Parameters: 

AH 

AL=0 

AL=1 

26H 

Get Power control state 
Set Power control state 

If AL=1 
DL 

Returns: 

If AL=0 

New state 

DL 

Current state 

If AL=1 
DL 

Old state 

Note; 

DL=0 

DL=1 

DL=2 

Normal Power-down on low battery 
Prevent Power-down but display warning 
Prevent Power-down with no warning 


This is used to prevent the Portfolio from powering down on a low battery. 

It is not recommended for use except for conditions in which a power down 
might be critical to an application or peripheral. 
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Fn 28H Get/Set Text/Keyboard language 


Parameters; 

AH 28H 
AL=0 Get Languages 
AL=1 Set Languages 
AL=3 Language table pointers 

If AL=1 

DX New languages 
Returns: 

If AL=0 

DX Current languages 

If AL=1 

DX Old languages 
If AL=3 

ES:CX Keyboard table pointer 
ES:DX Language table pointer 

Note: 

DH Text language 
DL Keyboard language 

Both DH and DL will be 1, 2 or 3, corresponding to the language in the 
ROM. 

If bit 7 of the language/keyboard code is set, then it remains unchanged. 

The tables consist of a count byte, followed by the language identification 
codes for the resident languages. These are as follows; 

ENGLISH 1 

FRENCH 2 

GERMAN 3 

SPANISH 4 

ITALIAN 5 

SWEDISH 6 

DANISH 7 
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Fn 2CH Get BIOS version number 


Parameters: 

AH 2CH 
Returns: 

DS:BX Address of BIOS version number 

Note: The version number consists of a Major and Minor version number, followed 
by a ’$’ terminator. A typical example is: ’1.050$’ 


Fn 2DH Turn system off 2.1.10, 2.5, 3.8 

Parameters: 

AH 2DH 
Returns: 

None 

Note: This is simitar to typing OFF at the command line. 


Fn 2EH Enable/Disable system status line 


Parameters: 


AH 2EH 

AL=0H Disable status line 
AL=1H Enable status line 

DH Row number 
DL Column number 

Returns: 

None 


Note: This is similar to invoking the status line using the LOCK key. 
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Fr> 30H File Transfer services 


4.2 


Parameters; 

AH 

AL 


DS;DX 


30H 

0 Transmit block 

1 Receive block 

2 Open ports 

3 Close ports 

4 Wait SOOmS 
Start of Data buffer 


If AL= 0 

CX Bytes to Send 

If AL= 1 

CX Maximum buffer size 

Returns; 

If AL=1 

CX Bytes Received 

DL Error Code 

0 No error 

1 Buffer size too small 

2 Timeout on transmission 

3 Checksum failure 

4 Invalid sub-service 

5 Peripheral not installed 

Note; This is used by the File Transfer utility built into System Setup. 


3.3.2 Disk services 

The Portfolio Credit Card Memory (CCMVDisk services are provided at the BIOS 
level by Int 13H. 

There are six standard diskette sub-services, plus one special service. These are as 
below/: 


OH Reset CCM/Disk system 

1H Get CCM/Disk status 

2H Read CCM/Disk sectors 

3H Write CCM/Disk sectors 

4H Verify CCM/Disk sectors 

5H Format CCM/Disk track 

83H Write CCM/Disk boot sector 
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Services 0 to 4 are similar to standard IBM PC BIOS disk services. They can access 
the three internally supported disk drives A. B and C (referred to as drives 0, 1 and 
2 respectively). 

Int 13H uses the BIOS Parameter Block (BPB) on the Boot sector (first sector) of 
the drive to determine the drive characteristics. During formatting, it is necessary to 
use a Format BPB, which is supported by service 83H. This service is used instead 
of service 5H to format the first track of a CCM/Disk. 

The parameters to service 5 are unlike those on a normal PC as detailed below: 


Int 


13H Fn 5H 

Parameters: 



AH 

5H 


DL 

Drive number 


DH 

Side/Head 

Returns: 

CH 

Track number 


CF=1 

Error code in AH 


Note: Writes defined byte onto one track of CCM. Byte is 
specified in the Disk base table. 

The Disk base table is similar to that used by an IBM PC. The table for both CCMs 
is pointed to by interrupt 1EH, and the table for the internal disk is pointed to by 
interrupt 41H. The format of both disk base tables is as below: 

Offset 03H Bytes per sector code (0=80H, 1 = 1 OOH, 2=200H) 

Offset OAH Format data bytes (Normally F6H) 


During formatting using Interrupt 61 H (see section 3.3.1), the CCM/Disk sector size 
is dynamically set according to the disk size. See below: 


Disk size 


Sector size 


0 to <=32 Kbytes 80H/128 bytes per sector 

>32 to <=64 Kbytes 100H/256 bytes per sector 

>64 Kbytes 200H/512 bytes per sector 

This ensures that a small disk size allows a reasonable number of sectors. Since 
Portfolio DOS allocates one sector per data cluster, this allows the same number of 
small data files on a 32K CCM as a 128K CCM. 


3-21 


There are various tnt 61H services that provide extended disk services (see section 


3.3.1. ): 


IntetH Fn 7H 

Format a CCM 

lnt61H Fn 8H 

Get the size of the Internal Disk 

InteiH Fn 9H 

Format the Internal disk 

InteiHFnOBH 

Determine if a valid CCM is present. 


Note: A CCM may also contain a BIOS extension \which does not affect the 
operation of the CCM, but can modify the Operating system or Power-down/Power- 
up sequence, (See section 3.5.) 
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3.4 Differences Between Portfolio DOS and MS-DOS 


For the purposes of this manual, Portfolio DOS is defined as the program which 
communicates between the Command processor or User application, and the BIOS, 
it does NOT include the Command processor. (See recommended books in section 
1 for more information on the standard MS/PC-DOS.) 

There are a few differences between Portfolio DOS and MS-DOS. These are mainly 
enhancements to Portfolio DOS 2.1 1 to make it more DOS 3. XX compatible: 

Int 21H Fn 37H Get/Set Country 

Portfolio DOS is DOS 3. XX compatible 

Int 21 H Fn 4BH Execute program 

As well as providing standard EXEC services it also allows a program to be 
RUN directly off a CCM (section 3.6.3). 

Int 28H Keyboard busy 

Not supported. This would normally be called during console 10 polling, 
however Portfolio DOS does not poll the console, but actually waits for a 
key using Int 16H Fn OH. (See section 3.8 on power management.) 

Int 2AH Internal MS-DOS function not fully supported 
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3.5 Device Drivers and Peripheral Software 
3.5.1 Device Drivers 


Device drivers are used by DOS to communicate with the BIOS. They provide a 
standard interface which isolates the DOS from the device specific BIOS. The 
Portfolio has the following resident device drivers in ROM: 

CON, CLOCKS. PRN, LPT1, AUX, COM1 and Disk driver 


These are all character devices that process strings of characters one character at a 
time. They are all identified by their names, 

The Disk device driver is a Block device which requires all 10 to be done in blocks. It 
addresses all the normal Portfolio disk drives (A, B and C). It has no name. 

It is possible to replace these resident device drivers (and add new ones) by the use 
of installable device drivers. These may be loaded by DOS using the ’DEVICE=' 
command in CONFIG.SYS. If a character device is loaded that has the same name 
as one of the above device drivers, then it replaces it. This mechanism is used by 
programs such as ANSI. SYS which is actually a CONsole device driver with added 
features. 

If a Block device driver is added, it supplements the existing Disk device driver. An 
example of this is the Virtual disk driver VDISK.SYS, which would add drive D:. 

The structure of an installable device driver is compatible with any MS-DOS 2.1 1 
devioe driver. 


CON 

PRN/LPT1 

AUX/C0M1 

CLOCKS 


performs all Console 10 

perform all Parallel (Printer) 10 

perform all Serial 10 

special driver to access the BIOS Clock 
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3.5.2 Peripheral Design 

There is a special design issue associated with Portfolio peripherals, due to the 
Portfolio auto power-down power conservation feature. This means that most 
peripheral devices will need to be re-initialized on power-up, (See Appendix C for 
more information.) 

There are two methods provided to fulfill this requirement: 

1) Int 61H Fn 1CH 

This service stores a list of lO addresses and associated data values, which will be 
output on a power-up. If all initialization specific lO writes are made via this service, 
then they will automatically be repeated on all power-up sequences. 

A typical use for this service might be to restore an interrupt number in an interrupt 
driven serial peripheral, 

2) Use a ROM extension. This would generally be required when the sequence of 
operations during power-up could not be supported by the Int 61H service. This will 
require the peripheral to contain an extension ROM. (See 3.5.3.) 

There are two exceptions to the above. The serial port parameters are read during 
the power-down sequence and correctly re-programmed on the subsequent power- 
up, The Parallel port is also initialized on Power up. 

Each peripheral is identified to the Portfolio by its Peripheral ID code (PID) (see 
section 2.7). This is actually a hardware lO location on the peripheral which may be 
read using Int 61 H Fn 1AH. 

The other software issue associated with custom peripheral design concerns the 
Serial or Parallel peripherals. If the custom peripheral wants to use existing BIOS 
services then they must identify themselves as being hardware compatible: 

int 61H Fn 1BH configures the BIOS to recognize a peripheral to be Serial or 
Parallel compatible. 
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3.5.3 ROM Extensions 


ROM extensions are sections of code that can be executed at various stages during 
the BOOT sequence, and during Power Up and Power Down. They may be on a 
Credit Card Memory (CCM) or on a extension ROM on a peripheral. A typical use of 
such an extension is to modify the operating system or initialize custom peripherals. 

There are three main types of extensions: A Specific BIOS extension, a Specific 
DOS extension, and Common extensions: 

* The Specific BIOS extension is invoked after BIOS initialization. 

* The Specific DOS extension is invoked after DOS initialization. 

* The Common extension is invoked before and after both BIOS and DOS 
initialization, before Command processor initialization and during Power-Down and 
Power-Up. 

The ROM extensions are searched for on Drive A, then the extension ROM and 
then Drive B. If a valid extension is found and executed, then the search for that 
particular type of extension is terminated. 

The format of a ROM/CCM extension is as follows: 


Offset 

Size 



OOH 

dw 

7 

;ldentification code 

02H 

db 

7 

;Number of 512 byte 
;blocks(unused) 

03H 

db 

5 dup (?) 

;Specific BIOS/DOS exten 

40H 

db 

’DIP ROMir 

;OEM user text 

50H 

db 

5 dup (?) 

:Pre-bios jmp vector 

55H 

db 

5 dup (?) 

:Bios-ext jmp vector 

5AH 

db 

5 dup (?) 

:Pre-dos jmp vector 

5fH 

db 

5 dup (?) 

;Dos-ext jmp vector 

64H 

db 

5 dup (?) 

;Post-dos jmp vector 

69H 

db 

5 dup (?) 

;Power-Down jmp vector 

6eH 

db 

5 dup (?) 

;Power-Up jmp vector 


The extension vectors occupy the first 128 bytes of the CCM/ROM. The vectors are 
positioned so as to allow a valid BIOS Parameter Block (BPB) on a CCM so that it 
can be used both as an extension CCM and as normal. The Identification code at 
Offset 0 determines the main extension type as below: 

AA55H iSpecific BIOS extension 

55AAH iSpecific DOS extension 

5555H iCommon extensions 
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Thus, if the word at Offset 0 is AA55H, then after BIOS initialization a FAR CALL will 
be made to Offset 3. The 5 bytes following this offset allow for a short/normal/far 
jump to the extension code. If the word was 55AAH, the call would be made after 
DOS initialization. If the word is 5555H, then all the common extensions would be 
called at the appropriate times. 

Note: Ail the jump vectors must be set up to a suitable return when using a 
common extension, even if they are not used. 

All ROM extensions must preserve the processor registers. Extreme care must be 
taken when using extensions, especially those which are invoked half way through 
the boot sequence, as these may adversely affect the operation of the Portfolio. The 
Pre-BIOS extension is called almost immediately on jumping from the Reset vector, 
and so has no stack set up, It must return via a FAR JUMP to 0FFFE:0H, All the 
other extensions must return via a FAR RET. It is recommended that the Post-DOS 
extension is used in preference to those preceding it. 

The OEM user text field at Offset 40H is to allow an OEM to identify the ROM. 

See Appendix C for examples of using an Extension ROM. 
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3.6 Memory Cards 

3.6.1 Format 

Each credit card memory (CCM) must be formatted before use, this program 
creates a format analogous with a standard floppy disk format. 

Alt formatted memory cards contain only 1 sector per cluster as opposed to the 2 or 
more found in larger systems. (See section 3.3.2 for more details.) 

The Atari Portfolio BIOS has been written to handle future paged Credit Card 
Memories (CCM). The BIOS assumes that the page register, is one byte located at 
offset 10 (OAH) within the Boot sector (First sector) of the Memory card. For this 
reason DO NOT use this memory location in programs. 


3.6.2 Autoboot Mechanism 

The Portfolio has the ability to invoke AUTOEXEC.BAT from drives other than drive 
C:. 

If a memory card is in drive A: or B: and AUTOEXEC.BAT file exists, it Is executed 
in preference to autoexec on C:. B: will have priority over A: if an AUTOEXEC.BAT 
exists on both A: and B:. 

If it is required that the AUTOEXEC.BAT on drive C: is always executed, terminate 
the batch file on drive A: with the command: 

C:AUTOEXEC 

The CONFIG.SYS file is always loaded from drive C: and cannot be overridden. 


3.6.3 Run 

A RUN file is a specially written program that can be directly executed from a Credit 
Card Memory (CCM) without having to be loaded into the Transient Program Area 
(TPA). An obvious advantage of this method of execution is that it minimizes system 
memory usage. 

A RUN file can be executed from the Command processor by typing RUN 
<filename>, or by invoking Int 21 H Fn 4BH at the DOS level as for a normal 
program, but with AL set to 80H. 
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There are several requirements for the programs wrhich can use the RUN command: 

* The program needs to be specialty \written to be used with the RUN command. 

* The program needs to be on drive A: or drive B: and it needs to occupy 
consecutive clusters on the disk. This situation cannot be guaranteed if a file is 
simply copied to the drive. 

* The file needs to have a .RUN extension. 

Writing .RUN Programs 

Almost all standard programs assume either that their data is in system RAM, or that 
they can store data in their code segment. Although a .RUN file is similar to a .COM 
file, care should be taken when dealing with data. 

The initialization code of the .RUN program has to perform the following (these 
points are illustrated in Appendix A); 

* Reduce the system memory usage down to the minimum requirement. There must 
be at least 10h paragraphs, i.e. the size of the PSP. 

* Allocate data and stack using DOS interrupt 21h fn 48h and set ss:sp to point to 
this block. 

* Copy all initialized variable data from the memory card to the allocated data block 
in system RAM. 

* The program can then perform most functions it wishes to, including any DOS 
calls. The program MUST terminate with DOS interrupt 21 h function 4Ch 
"terminate process". 

* The program does not need to copy the non-variable (constant) data from the 
ROM card into RAM before using it. This data can be used directly from the card. 
This means prompts or text messages need not take up any RAM. 

The built-in applications can be invoked while a program is being RUN using the hot 
keys as usual. 

If during execution of a RUN file the Credit Card Memory (CCM) is removed from 
the drive, the next instruction to be executed on the card will be interrupted by an 
error handler. This displays the error message: 'ERROR: Card Access’ and 
terminates the process. A RUN file may not EXEC another file from within itself. 

Appendix A provides an example of a RUN program which illustrates how to 
program a typical RUN program. 
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3.7 Screen Handling 

The Portfolio BIOS supports two main Video modes, Text and Graphics. The BIOS 
Video Interrupt 10H may be used to set the screen mode: 


Mode 

Type 

PC Resolution 

Portfolio 

Mode 7 

Text 

(80,25) 

<80,25> 

Mode 8 

Graphics 

(160,200) 

<160,64> 

Mode 9 

Graphics 

(320,200) 

<240, 64> 

Mode A 

Graphics 

(640,200) 

<240, 64> 


As can been seen, the Portfolio interpretations of these modes is fairly simple. 

The Text modes are actually viewed using a 40x8 window. There are 3 sub-modes: 
Static PC, 40x8 and Tracked. 

Static PC mode is where the physical screen area acts as a window onto the larger 
80x25 text screen. The window may be moved using the Alt-Cursor keys, or Int 61 H 
Fn 11H. 


40x8 mode actually sets the logical screen size to 40 columns by 8 rows. This mode 
is intended for use by software written specifically for the Portfolio, such as the the 
Command processor and the Internal applications. 

Tracked mode is similar to static mode, except that the Screen window positions 
itself at the cursor. 


This mode can be set using Int 61 H Fn OEH. 


The Video RAM (VRAM) for the text screen is at segment OBOOOH therefore it is 
possible to write directly to the Video RAM, but any screen refreshing must be 
invoked by the application. There is only one text page. 


There are other Int 61 H Video services: 


lnt61HFn ODH 
InteiHFn OFH 
!nt61H Fn 10H 

InteiHFn 12H 


get the logical and physical screen sizes 
Set cursor size 

Set the virtual screen window origin 
on the 80 by 25 screen 
Force a screen refresh. 


In Graphics mode, the Graphics screen has a 240 by 64 pixel resolution and can be 
written to or read from using BIOS pixel read/write Int 10H Fn OCH or Fn ODH 
respectively. The Atari Portfolio has three cursor modes: Block, Underline and Off. If 
the cursor size is set in the BIOS then either Block or underline mode will be set up. 
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3.8 Power Management 

The Portfolio is designed to minimize power consumption and hence maximize 
battery life. This is reflected in the hardware design, but is enhanced by various 
software features. 

The main power wasting operation in most computers is waiting for user entry at the 
keyboard. Once the Portfolio Keyboard BiOS Getkey ready service (int 16H Fn 0) 
has detected keyboard inactivity, it wiil start to decrement a timeout counter. On 
timeout, the Portfoiio wiil enter its power-down sequence. Once powered-down, any 
hardware interrupt wilt initiate a power-up sequence. 

This timeout is dependent on whether the machine is set to fast or slow timer ticks 
(Int 61H Fn 1FH), but is always between 128 and 256 seconds. 

It is important that all keyboard input is done via a DOS or BIOS keyboard service 
that waits for a key press. Polling the keyboard continuously will quickly wear out the 
batteries. This will be obvious as the Portfolio will never power down. 

Another power wasting operation is refreshing the LCD controller from the Video 
RAM. If an application writes directly to the Video RAM, then it must be refreshed at 
appropriate intervals using Int 61 H Fn 12H. It is possible to force a screen refresh 
on a keypress or on a timer-tick using Int 61 H Fn 1FH. Many applications which run 
on the Portfolio, but are designed for the IBM PC require this refresh on keys as 
they assume automatic screen refreshing. Refresh on timer ticks is dependent on 
the tick speed. This can be set using Int 61 H Fn 1EH. 

Note: The timer tick (Int 8H and Int 1CH) is not the same as the IBM PC timer tick 
which occurs 18.2 times a second. It is either generated once every 128 seconds, or 
once per second. 

As a general rule, an application should avoid refreshing the screen except where 
necessary. With refresh on both keys and timer ticks, and with timer ticks set to fast 
(i.e. 1 tick per second), the processor spends a lot of its time refreshing the screen. 

Generating sounds using Sound generation. Melody tone generation or Tone 
dialling (Int 61H Fn 15H, 16H or 17H respectively) can draw a high current from the 
Portfolio batteries. 

The Alarm will timeout after about 15 seconds to prevent the batteries from being 
overly strained. 
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All peripherals will add to the power consumption, unless they have their own power 
source. It is recommended that an external power supply is used wherever practical 
when using peripherals. 

During Disk access, Tone generation, Timer tick and on each press of the return 
key, the Portfolio checks to see if its batteries are running low. If a low battery is 
detected, the Portfolio automatically powers down after displaying a low battery 
message. On power up, it will display the same message to indicate to a user the 
reason why it powered down. 

It is possible to prevent the Portfolio from powering down using Int 61H Fn 26H. This 
service must ONLY be used if absolutely necessary, because this may force the 
Portfolio to operate outside its electrical specification with possible damage to the 
hardware. 
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3.9 Special File Formats 
3.9.1 Diary saved file format 

The built in diary saves its data in a standard ASCII file format. To eliminate different 
date formats for different countries, the Diary stores the information in English 
format. 

Certain information, such as repeat entries and alarm information is saved along 
with the diary entries. 

The following Is an example diary file: 

6/07/89 

14:14 Technical reference 
20:00 Go home 

If an entry is a repeating entry, the time is preceded by a code letter indicating the 
repeat period. The following table lists the code letters and their associated repeat 


periods; 


d 

Daily 

w 

Weekly 

n 

Non weekend, i.e, Mon-Fri 

m 

Monthly 

y 

Yearly 


if an alarm is associated with an entry, the symbol is placed on the line before 
the time. 

If an entry has an alarm and it is a repeating entry, the repeat symbol proceeds the 
alarm symbol. 

For example: 

6/07/89 

@ 20:00 Go home 

7/07/89 

d 14:48 Hello there! 
w@ 18: 10 Goto tennis 

The first entry is a non repeating entry with an alarm. The second is a daily repeat 
and the third is a weekly repeat which will sound the Portfolio’s alarm. 

The diary sorts the entries chronologically when it loads any given file. 
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3.9.2 System File Formats 


There are three files used by the system which obey a standard file format. These 
are: 

Clipboard (C:\SYSTEM\CLIPBORD.DAT) 

Undelete (C:\SYSTEM\UNDELETE.DAT) 

Permanent data (C;\SYSTEM\PERMDATA.DAT) 

All three files are loaded into RAM when the applications are invoked. Operations 
affecting any of the information stored in these files only change the RAM copy. All 
three files are written out when the user quits all the applications, i.e. presses 
<ESC> at the top level menu. 


3.9. 2.1 CLIPBORD.DAT 

This is the file which the applications use as the clipboard. It Is a single block of data 
ending with a zero byte (OOh). Carriage returns are stored as ODh without the trailing 
OAh Line feed. The maximum size of the clipboard is 8K characters. This must 
include the 0 terminator, 

If the file does not contain a OOh termination byte, then the file is not loaded into the 
clipboard. Similarly, if the file is greater than the maximum number of allowed 
characters, it isn’t loaded. In both cases when the file is not loaded, it will be 
overwritten with a fresh file upon exit from the application. 

If the clipboard has the normal text format of ODh, OAh the file will only load correctly 
into the Editor and the Diary. 


3.9.2. 2 UNDELETE.DAT 

The undelete file is used to store all the characters or blocks of data deleted from all 
the applications. It is made up of a number of "blocks" of data. Each block 
represents a group of characters deleted with one command. The format of a block 
is as follows: 

<DATA> <00h> <DIR> 

The <DATA> is the character or characters which are deleted. If a block of data is 
deleted containing carriage returns, these are stored as <0Dh>, not <0Dh><0Ah>. 

The OOh byte is used to determine the length of the deleted block. 
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The <DIR> is a one byte code indicating in which direction the deletion was made. If 
the data was deleted to the left, i.e. using the BACKSPACE key. then this byte will 
contain <00h>. If the data was deleted from the right, i.e. using <DEL>, this byte will 
be <01h>. 

The maximum number of characters which the undeletion file can contain is 2000. If 
the file contains more than this number of bytes, then it will be ignored and replaced 
with a new file upon exiting from the application. 

If the UNDELETE.DAT file doesn’t have the correct format, the effects are 
unpredictable. It is likely the data in the file will be inaccessable. 


3.9. 2.3 PERMDATA.DAT 


The format of the system data file is as follows; 


Byte(s) 
in Hex 

0 

1 

2 

3 

4..6 


7 

8., 56 
57 

58.. 5b 
5C 

5d 

5e..60 


61 

62..b0 

b1..b4 


b5 

b6..104 

105.. 106 

107.. 108 

109.. 10a 
10b 

10c 

bOd.lOe 


Funclion 


Non zero: undelete buffer enabled. 

Non zero: undelete buf Is saved on exit 
Non zero; clipboard Is enabled. 

Non zero; clipboard is saved on exit 
Reserved. 

Worksheet; 

Non zero: frame on upon entry. 
Drive/Path/Name of last used file. 

0: Autoload last spreadsheet, Offh don't 
3 character 0 terminated currency string. 
Initial decimal point, ’.’(2eh) or ',’(2dh) 
Printer default paper width. 

Reserved. 

Diary: 

Non zero: frame on upon entry. 
Drive/Path/Name of last used file. 
Reserved. 

Editor; 

Non zero: frame on upon entry. 
Drive/Path/Name of last used file. 

Top line on screen 0 is first line in file 
Current cursor line no, 0 is first line. 
Cursor; number of bytes into current line. 
Right margin. 

Non zero: word wrap on. 

Reserved. 
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Address book; 


lOf 

Non zero: frame on upon entry. 

110.. 15e 

Drive/Path7Name of last used file. 

15f..168 

Dial prefix in ASCII, zero terminated. 

169.. 16f 

Reserved. 

Calculator: 

170 

Non zero: frame on upon entry. 

171..1bf 

Reserved. 

IcO 

Ml sign: Bit 7 set for negative number. 

1c1..1c2 

Ml exp: signed word, 0:1.000<=mant<2.000 

1c3..1ca 

Ml mantissa. 

1cb..1d5 

Memory 2. 

1d6..1e0 

Memory 3. 

1e1..1eb 

Memory 4. 

1ec..ll6 

Memory 5, 

1t7 

Format; O-General, 1 -Fixed, 2-Sd., 3-Eng. 

IfS 

Number of decimal places 

1f9 

Separators: 0 - none, non-zero-separators 

Ifa 

Decimal point: 0 - non-zero 
Setup: 

Ifb 

Reserved. 

1fc..24a 

Drive/Path/Name of printer file destination 

24b..24e 

Reserved. 

24f 

Printer dest, 0:Parallel, 1:Serial, 2:tile. 

250 

Lines per printer page. 

251 

Printer setup code length. 

252..2d1 

Setup codes, ASCII chars, i,e. ESC=1Bh. 

2d2 

End of line code 0 <CR> 

1 <CR><LF> 

2 <CRxLF><LF> 

2d3 

Number of top paper margin lines, 

2d4 

Bottom paper margin lines. 

2d5 

Left paper margin character indent. 

2d6 

Baud rate 0 iio 

1 150 

2 300 

3 600 

4 1200 

5 2400 

6 4800 

7 9600 

2d7 

Parity 0 None 

1 Odd 

3 Even 

2d8 

Data bits 2 7 bits. 

3 6 bits. 

2d9 

Stop bits 0 1 stop bit. 

1 2 stop bits. 

The PERMDATA.DAT file currently contains 730 bytes. 
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3.10 IBM PC Development system 


The Portfolio contains a few system specific extended BIOS functions which are 
accessed using interrupt 61H. If you want to emuiate these functions when 
developing programs on a standard IBM PC then this is possible by running the 
program 161. EXE on a PC, This program will remain Terminate and Stay Resident 
(TSR) and hence enable you easily develop custom programs. To ensure upward 
compatibility of your programs, if you plan to use any 161 functions then make sure 
that you use I61 Fn OH first, (See section 3.3.1.) 

Int 61 H Services supported by IBM hosted version: 


Fn No 

Function description 

Supported 

OH 

Service Initialization 

/ 

7H 

Format Credit Card Memory 

X 

8H 

Get size of Internal disk 

/ 

9H 

Format Internal disk 

X 

BH 

Determine if CCM present 

X 

DH 

Get/Set Screen size 

/ 

EH 

Get/Set Screen mode 

/ 

FH 

Get/Set Cursor mode 

/ 

10H 

Get/Set virtual screen position 

/ 

11H 

Move virtual screen position 

X 

12H 

Screen refresh 

X 

15H 

Sound generation 

/ 

16H 

Melody tone 

/ 

17H 

Dial number 

/ 

18H 

Mute states 

/ 

19H 

Get Serial port parameters 

/ 

1AH 

Get Peripheral ID byte 

X 

1BH 

Set Peripheral ID byte 

X 

ICH 

Preset Peripheral 10 data 

X 

lEH 

Get/Set Clock tick speed 

/ 

1FH 

Get-key/Tick Screen refresh 

'/2 

20H 

Disable revectoring of Int 9H 


24H 

Get/Set ROM space state 

X 

26H 

Get/Set Power State 

X 

28H 

Get/Set Language 

/ 

2CH 

Get BIOS version number 

/ 

2DH 

Turn system off 

X 

2EH 

Enable/Disable status tine 

/ 

30H 

File transfer via smart cable 

/ 

Key: 

/ Service supported 



X Service not supported 

Vi Service partly supported 
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4 PERIPHERALS 


4.1 Portfolio Serial Communications 

4.1.1 Hardware Specification 


standard; EIA RS232C compatible 

Line Voltages: +/- 9V 

Current Loop: Not Supported 

Connector; 9 Pin D-Shell Plug <AT compatible) 


Connector Pin out: 


Interface 1C: 

Base Address of 82c50: 
Interrupt Support: 
Divisor Clock: 


Pin 

Name 


1 

CD 

Carrier Detect 

2 

RD 

Receive Data 

3 

TD 

Transmit Data 

4 

DTR 

Data Terminal Ready 

5 

GND 

Signal Ground 

6 

DSR 

Data Set Ready 

7 

RTS 

Request To Send 

8 

CTS 

Clear To Send 

9 

Rl 

Ring Indicator 


82C60A 

Stored at Memory Location 400h 
Yes (see below) 

1.8432 MHz 


4.1.2 10 Registers 

Since the same computer interface (with the exception of interrupt handling) is used 
on the Portfolio as on the IBM PC/AT, the 10 registers have the same function. The 
base address for the serial port may be found by reading memory location 400h in 
the BIOS data area. If the value at this address is XXXXh, then the 10 registers are 
thus; 


10 Address Register of 82c50A 


XXXX+0 

R 

RBR 


W 

THR 

XXXX+1 

R/W 

lER 

XXXX+2 

R/W 

HR 

XXXX+3 

R/W 

LCR 

XXXX+4 

R/W 

MCR 

XXXX+5 

R/W 

LSR 

XXXX+6 

R/W 

MSR 

XXXX+7 

R/W 

SCR 


Receiver Buffer Register 
Transmitter Buffer Register 
interrupt Enable Register 
Interrupt Identification 
Line Control Register 
Modem Control Register 
Line Status Register 
Modem Status Register 
Scratch Register 
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4.1.3 Interrupt Support 

Since the Portfolio does not contain an 8259 compatible Peripheral Interrupt 
Controller, interrupts are handled in a different way than on an IBM PC/AT. 

The serial port has register called the Serial Interrupt Vector Register (SIVR). An 
eight bit number can be written to this register. This number is the interrupt number 
that is to be used with the serial port. For example, writing 10 to SIVR will cause a 
call to the double word pointer held at memory address 10*4. 

SIVR is at I/O location 807Fh and is write only. It should be set up before 82c50A 
interrupts are enabled, 

When an interrupt is generated by the 82c50A, it is passed on to the CPU. If no 
other interrupts are pending then the CPU will read the contents of SIVR and 
service that interrupt number. 

Interrupts are acknowledged by accessing the 82c50A and reading NR. This will 
allow the operation required to service and acknowledge the interrupt to be 
determined. 


4.1.4 Other Useful Information 

To determine whether a serial port is installed, it is recommended that use is made 
of BIOS interrupt 1 1h - Get Equipment List. 

Since the Portfolio will attempt to power down while waiting for a key stroke (INT 
16h service OOh), it is recommended that terminal emulation software polls the 
keyboard until a key is waiting in the buffer (INT 16h service Olh). 

To set up SIVR it is recommended that INT 61h service ICh is used: 

AH = ICh 
AL = 0 
BH = 5 

BL = Byte to write 
DX = 10 address 

Use of this function will ensure that SIVR is always set up correctly (unless table 
entry 5 is reused for a different address). 

In order to maintain future compatibility it is recommended that on exit from the 
program, the table entry used above have its address set to zero. This should be 
followed by a write of 2Ah to I/O 807Fh. 


;set up 10 address 
;IO table entry 5 
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4.2 Smart Parallel Interface 
File Transfer Protocol Description 

The IBM PC and many compatibles have uni-directional centronics parallel ports. In 
order to allo\A/ an inexpensive but useful peripheral it was decided that the Portfolio 
parallel centronics port would allow programs to be sent to and from IBM PCs as 
well as to a printer. This is accomplished by using a synchronous serial transfer 
protocol. Status lines on the IBM PC which can be accessed through the BIOS are 
used as inputs on the IBM. The Portfolio parallel port is fully bi-directional. 

The file transfer BIOS should be used with the following considerations (see section 
3.3.1): 

* Before sending or receiving the ports should be opened. 

* Sending a block expects the other end to be receiving a block, and visa versa. 

* A timeout will occur if there is no answer within 500mS. 

* Sending a block will automatically transfer the length of the block. The receiver will 
return an error if the buffer is too small. 

* On any failure, wait SOOmS (to allow the other end to timeout) and attempt to re- 
transmit/receive the block. 

* A error at one end will normally cause an error at the other, so block order should 
not be lost. 

* A checksum will be sent with each block to provide simple error detection. 

* At the end of the transfer the ports should be closed. 
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4.3 IBM PC Card Drive 


The IBM PC card drive consists of an expansion bus card and plastic box with a 
cable, The expansion card can be used in a IBM PC/AT or compatible. The cable is 
used to connect the card to the plastic box. There is a slot in the front of the box that 
allows the insertion of a Credit-card memory, as used on the Portfolio. 

By running the appropriate block device driver software, the card drive can access 
the card in the same way as a normal disk. 

The card uses a block of four I/O locations. These are located at a start address 
indicated by optional links on the board. When these are changed from the default 
setting, the device drive driver must be told of the change in the CONFIG.SYS file. 
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4.4 EPROM Writer Adaptor Boards 

PROM programming adaptors are available which allow PROM (OTP) memory 
cards to be programmed using a standard PROM programmer. The adaptors 
convert the PROM card to the same outline as a standard OIL PROM. Use model 
HPC-501 to program 512 KBit cards and model HPC-502 for 1 Mbit cards. 

When programming the PROM card the PROM programmer should be set up as a 
Fujitsu PROM. If however, Fujitsu settings are not available, some of the other 
12.5V PROM programming specifications will also work. The ideal programming 
specification is; 

VPP 12.5 V 

64 KByte use27C512 ’ {Ideally Fujitsu CMOS) 

128 KByte use 27C1001 (Ideally NEC CMOS) 

Once the correct ROM type has been chosen use the following procedure to make a 
copy of a RAM card; 

0 Select a PROM card with the same capacity as the RAM card and use the correct 
adaptor for the card capacity 

ii) Place adaptor in PROM socket of the programmer, ensure that it is inserted the 
correct way. 

iii) Place RAM card in to adaptor and LOAD the contents in to the programmer 
using the relevant option. 

iv) Place PROM card in to the adaptor and program as for a normal PROM chip. 


WARNING: 

1) DO NOT ATTEMPT TO PROGRAM THE RAM CARD 

2) Some PROM programmers do not like the power being turned ON and OFF so 
remove the cards before switching ON or OFF. 
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APPENDIX A: EXAMPLE .RUN PROGRAM 


Section 3.6 highlights the main design issues to take into account when creating a 
■RUN program. 

Included on the Portfolio Emulator Disk are the following files: 


The above files illustrate two programs which use the Atari Portfolio .RUN function. 

RNRN is an assembler program which prints out the original calling parameters and 
then three numbers. 

MAIN is a program which illustrates a .RUN program written in C. RU_C.ASM is the 
C Header necessary for Borland's Turbo C compiler and BUILD.BAT illustrates how 
to create the program using Turbo C tools. 

Notes on interfacing 'C files to the RUN command 

For 'C’ files, several more segments need to be declared to ensure ’C’ gets the data 
and code in the correct positions in the .RUN file. The .COM file is converted into a 
.RUN file by renaming. 

RN_C.ASM is the header which can be used to interface to a ’C’ program, if ’C’ 
source files are being used without any provided ’C’ libraries then the file RU_C can 
be used as the header directly. If library code is required the header will need to be 
enhanced to perform the necessary library initialization. 

The RN_C.ASM header works with Turbo C and can be used as a guide to 
modifying other ’C’ headers used by different ’C compiler libraries. 

Most ’C’ headers supplied with 'C compilers can be assembled for different memory 
models. The example code in RN_C.ASM needs to be placed in the ’C’ startup 
header and assembled for the SMALL model (sometimes called TINY). 


RNRN.ASM 

MAIN.C 


Assembler .RUN program 
Example C .RUN Program 
C Header 

creates program using Turbo C tools 


RU_C.ASM 

BUILD.BAT 
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TITLE RNRN.ASN 


comnent * 

(c) Copyright DIP, 1989 

Example .RUN program 
* 

DGROUP group text, data, cdata 

STACKSIZE equ 400 ; byte in stack. 

: code segment. 

_text segment public byte 'CODE' 
assume cs:_text,ds:_data 

org 0 : IP is 0 on entry. 

r 

; rnrnjnain 

t 

; RUM command test routine. 

: On entry, OS, SS and ES all point to the PSP in RAM. 

; CS is a ptr into the credit card, so may actually be in ROM! 

; When this routine is executed, the whole of RAM is allocated to the 
; process. 

t 

: Parameters: 

: None 

: Returns; 

: None 


in 

proc near 



mov 

bx,10h 


: 

lOh paras to keep the PSP. 

mov 

ah,04ah 


* 

modify memory. 

int 

21h 




jc 

rnrn err 


t 

error reducing memory. 

mov 

bx, OFFSET 

rnrnuend 

* 

alloc for initialised data. 

sub 

bx, OFFSET 

rnrn dstart 

I 

uninitialised data and a 

add 

bx,0fh 



; stack. 

mov 

cl, 4 




shr 

bx,cl 


f 

calc paras in init data area 

add 

bx,STACKSIZE/16 

t 

add in paras in stack. 

mov 

ah,48h 


' r 

allocate memory. 

int 

2lh 


1 

allocate stack and data. 

jc 

rnrnerr 


r 

no memory. 

mov 

ss,ax 


j 

set stack to point to RAH. 

mov 

sp, OFFSET 

r nr n_ ue nd + STAC KS I Z E 

push 

es 



preserve PSP pointer. 

mov 

cx, OFFSET 

rnrn dend 



sub 

cx, OFFSET 

rnrndstart 


bytes in initialised data. 

mov 

si, OFFSET 0GR0UP:rnrn 

dstart : copy from here. 

push 

CS 




pop 

ds 


1 

source is on memory card. 

xor 

di ,di 




mov 

es,ax 



target is allocated RAM, 

cld 





rep 

movsb 


: 

copy init data from card to 

pop 

es 


t 

restore PSP ptr. 

mov 

si ,5dh 




mov 

cx,ll 
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rnrnfcbl: 

mov dl,es:[si] : get char from FCB built Into PSP. 

i nc si 

mov ah, 2 

int 21h : print nanie of first parsed FCB. 

loop rnrn_fcbl 

niov si,6dh 

mou cx,ll 

rnrn fcb2: 


mov 

inc 

mov 

int 

loop 

dl ,es:[si] 
si 

ah, 2 
21h 

rnrn fcb2 

: print name of second parsed FCB, 

push 

pop 

ss 

ds 

: DS is ptr to data in RAH, 

mov 
cal 1 

al ,_rnrn_val 
rnrndisp 

; get initialised data. 
; display the value. 

inc 

rnrn^val 


mov 
cal 1 

al ,_rnrn_val 
rnrndisp 

: get changed data, 

: display the value. 

my 

mov 

call 

rnrn_unin,44 
al ,rnrn_unin 
rnrn_di sp 

; set a piece of uninitialised data. 
: get uninitialised data, 

; display the value. 

xor 

jmp 

al,al 

short rnrnend 

; return errorlevel of 0, 


rnrnerr: 

mov 

push 

pop 

niov 

int 

tnov 


dx, OFFSET DGROUP:rnrn_mefii 
cs 

ds ; 
ah, 9 : 
Zlh : 
aM : 


write directly from ROM card! 
write string, 

tel 1 user there was memory error, 
terminate with error code of 1, 


rnrnend: 

push ax 


save errorlevel code in al. 


mov ah,l ; wait for a key. 

int 21h 


pop ax 

mov ah,4ch 

int 21h 

rnrn^main endp 


; get errorlevel code back. 
: terminate process. 


rnrn_disp 

Display the value in At with a trailing space. 

Parameters: 

AL Value to print, less than 100. 

Returns: 

Wone 

********lfc***lt***********!fe***'#**A*Alfc'i£*ll£** ************************* ******** 


sp 

proc near 


aam 


: convert to two numbers. 

add 

ax,3030h 

: convert to ASCII digits 'O’ 

push 

ax 

: save to print 2nd char. 

mov 

dl ,ah 


mov 

ah, 2 

: print 1st digit. 

int 

21h 
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: print 2nd digit* 


pop 

dx 

mov 

ah, 2 

int 

21h 

mov 

dl/ 

mov 

ah, 2 

int 

21h 

ret 

sp 

endp 


text ends 


print a space* 


; initialised and uninitialised RAH data* 

: tnis is para since the segment will start at zero when it is copied 
: over into RAH, 

_data segment public para 'data' 


rnrndstart 

label 

byte 



public 

rnrn 

val 



rnrnval 

db 

42 



rnrn_dend 

label 

byte 



rnrn_ustart 

label 

byte 

: uninitialised data 

start 

rnrn uni n 

db 

? 



rnrnuend 

label 

byte 

; uninitialised data 

end. 


: the stack is added on here, after initialised and uninitialised data, 
data ends 


_^cdata segment public byte 'data' 

: initialised data which doesn't get transferred to RAM, 
rnrnjr^m db "Out of memoryS” 


cdata ends 

end rnrn main 
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minx 


Copyright DIP Ltd, 1989 

RUN file 'C interface main program. 


V 


char buf[2]: 


/* this is BSS, unitialised. */ 


char *str=”Heno world"; 


/* this is DATA, initialised. */ 


unsigned int _brklvl; 


/* required by Turboc library. */ 


int main() 

( 

puts(str) ; 

buf [0]=' > ‘ ; 
buf[l]=0: 

puts(&buf [0] ) ; 


/* print initialised hello. V 


/* initialise uninitialised data. */ 


/* print uninitialised data, v 


ret urn (0) ; 

) 

void _exit() 

/* 

Ourrmy exit function required for the Turboc libraries. 
V 
{} 
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TITLE RU_C.ASM 
comment * 

Copyright DIP Ltd,, 1989 

'C header for creation of .RUN files, 

Meniory usage: 


SP: 



Stack 

Un initial i sed data 

OS/SS; 

Initialised data 



ES: PSP 

Low menK>ry 


: Segnient and Group declarations 

; code and fixed data (less than 64k}, 

TEXT SEGMENT BYTE PUBLIC 'CODE' 

JEXT ENOS 

; code ends (marker segment) 

^TEXTEND SEGMENT BYTE PUBLIC 'CEND' 

JEXTEND ENOS 

: initialised data transferred into RAM, 

DATA SEGMENT PARA PUBLIC ^DATA^ 

_DATA ENOS 

; uninitialised data which is allocated space in RAM, 
^BSS SEGMENT WORD PUBLIC ^B$S^ 

BSS ENDS 


: uninitialised data end (marker segment), 
_BSSEND SEGMENT BYTE PUBLIC ^STACK^ 

BSSEND ENDS 


DGROUP GROUP DATA, _BSS, BSSEND 

ASSUME CS:_TEXT, OStOGROUP 


dgroup is all data segments. 


extrn 

_main:near 

: main 'C routine. 

STACKS IZE 

equ 128 

: stack size in bytes. 

: At the start. 

SS, DS and ES all point to the program segment prefix. 

: CS IS a ptr into the rneniory card. 


_TEXT SEGMENT 

org 

0 

: ip is zero on entry. 

start proc 

near 

; near is irrelevant, use fn 4c to 
: terminate. 

mov 

dx,ds 

; ensure DS:0 is ptr to 1st data byte. 

add 

dx,10h 

mov 

ds,dx 


mov 

bx,STACKSIZE 


add 

bx, off set DGROUP:edata 

; bx has bytes of reqd RAM, 

push 

bx 

: this will be stack ptr. 

shr 

bx,l 


shr 

bx, 1 


shr 

bx,l 


shr 

bx,l 


add 

bx,llh 

: lOh for PSP, 1 for rounding. 
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inov ah.4dh 

int 21h 

jc abort 



pop 

bx 


mov 

ax,ds 


nx)v 

ss,ax 


mov 

sp.bx 


push 

ds 


pop 

es 


push 

cs 


pop 

ds 


mov 

si . offset TEXT:etext 


add 

si, OFh 


and 

si. OFFFOh 


xor 

di ,di 


mov 

cx. offset OGR0UP:bdata 


inc 

cx 


shr 

cx. 1 


cld 



rep 

movsw 


push 

es 


pop 

ds 


mov 

di. off set DGROUPibdata 


mov 

cx. off set DGROUPiedata 


sub 

cx.di 


xor 

al.al 


rep 

stosb 


call 

main 


mov 

ah.4ch 


int 

21U 

abort: 

mov 

ax.4cGlh 


int 

21h 

start 

endp 


JEXT 

ENDS 



TEXTENO SEGMENT BYTE PUBLIC *CEND' 


etext 

label 

byte : Last 

JEXfENO ENDS 


^OATA 

SEGMENT 



public 

errno 

errno 

dw 

5 

^DATA 

ENDS 


^BSS 

SEGMENT 


bdata 

label 

byte 

JSS 

ENDS 


^BSSENO 

SEGMENT 


edata 

label 

byte 

JSSENO 

ENDS 



end 

start 


; reduce RAH to required RAM* 
; can't reduce. 

: get calc'd p back. 

; stack is in RAM. 


; target is allocated RAM after PSP. 


; source is memory card. 

: get ptr to last byte in code. 

: round up to 1st byte in data. 

; data is para aligned on the card. 

: ds:si is ptr to start of init data. 

; put data at 0 offs into alloc'd RAM. 

: es:di is ptr to alloc'd RAH target. 

: get bytes in initialised data. 

: round up: ensure last byte is copied. 


; copy init data from memory card. 


: DS back to ptr to RAM. 

; ptr to where uni nit data goes in RAH. 
: ptr to end of all data. 

: calc bytes in 8SS. 

: clear to zero. 


: inyoke program. 

: terminate with main's return code. 


; abort with error. 


of text segment 
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0 

1 

1 

3 

4 

5 

6 

7 

8 

9 

10 

U 

12 

13 

14 

15 
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APPENDIX C Example peripheral design 

As an illustration of a typical Atari Portfolio peripheral we have designed a 
peripheral which flashes an LED in time with the system tick. In order that this 
peripheral operates transparently to the user we have used a ROM extension. 

Peripheral Specification 

i) have a single LED which will toggle on a timer tick. 

ii) have a PID of 64h. 

iii) have all software on an extension ROM. 

iv) only operate with the machine powered on. 

v) be a terminating peripheral. 

vj) the peripheral will power up with the LED off. 

Hardware Design (see schematic) 

See section 2.6 &. 2.7 for more information. 

* There is decode logic to read the PID from 807Fh. (Since there is no need find out 
if the LED is on or off, the latch will be decoded for a write at 807Fh, to save 
decoding logic.) 

* Each successive write to 807Fh will toggle the LED 

* If the latch is set, the LED will be ON 

* If the latch is reset, the LED will be OFF 

* The circuit will be powered from 5VS 

* The buffering signals ABUF/BBUF and PDET are also used 

Software Design (see listing of file PDEM.ASM) 

* A ROM extension will be used to hook a TSR onto INT 1Ch 

* Each call to INT 1Ch will toggle the LED by writing to I/O 807Fh. 

* If the peripheral is removed, the TSR will de-install itself. 

* On power up, the LED is assumed to be reset. 

ROM Extensions (see listing of XROM.ASM) 

This example program illustrates how to design a simple ROM extension. It can 
either function as a specific BIOS, specific DOS. or Common extension, according 
to the ID code at 0C000:0. Each extension module identifies itself, and where it was 
invoked from. It is a good demonstration of the potential power of ROM extensions. 
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SCHEf^ATIC FOR EXA^IPLE PERIPHERAL 


***#***********l^!****************#^^***i*** ******** ************** 

Module; PDEM.ASH 

Copyright: DIP Ltd, 1989 

Peripheral ROM Extension 

******************* **************************** **************** 


name XROM 



assume 

cs:cseg,ds:dseg 



DOSX 

equ 

055aaH 


;Specific DOS extension 

cseg 

segment 





org 

OH 


; Extension Vector table 

xronimain 

label 

near 


: Start label for MASH 

bi xttype 

dw 

DOSX 


;Identification code 

bixt_si ze 

db 

0 


:Num 512 byte blocks in ROM 


org 

3H 



bixt gdos 

label 

byte 


:Specific DOS extension 


iw 

genxvect 


^Specific extension vector 


org 

40H 



bixt user 

label 

byte 


:0EM user text 


db 

'Crt Plant Periph' 



:The plan is to allocate 

some n>emory. Copy a section 


; of code to memory, and 
: vector to that code. 

then 

point the Specified 

xroni proc 

proc 

EAR 



INTRjyHB 

equ 

IcH 


:TIHER TICK 

genxvect 

label 

near 




push 

ax 


; Preserve registers 


push 

bx 


: required to set up 


push 

ds 


: local stack 


: Allocate User RAM, Note 

that 

this can ONLY be done 


: after DOS initialisation. 



mov 

bx,(AL0C SlZE+OfH)/10H 

: Paras to allocate 


nx)v 

ah,48H 


: Allocate memory 


int 

21H 




m\f 

ds,ax 


:Set OS to allocated RAM 


mov 

stak save^ss 


iPreserve Caller stack 


mov 

stak_save+2,sp 




shl 

bx, 1 


:Convert size to bytes 


shl 

bx,l 



shl 

bx, 1 




shl 

bx, I 




:Set up 

User stack. 




mov 

ss,ax 


:Set up stack at top 


mov 

sp,bx 


; of allocated memory 


push 

cx 


: Preserve registers 


push 

dx 


: YOU MUST ALWAYS PRESERVE 


push 

si 


I ALL USER REGS 


push 

di 




push 

bp 




push 

es 
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;Copy the ISR to the allocated area 


xromproc 

PIDJODE 

LEDS_P0RT 

tick code 


push 

ds 

push 

cs 

pop 

ds 

mov 

si*offset tickcode 

push 

ss 

pop 

es 

mov 

di* off set load_base 

mov 

cx*C00EJlZE 

eld 


rep 

movsb 

pop 

ds 

; Get 

the specified vector* < 

mov 

ax,3500H+INTR NUMB 

int 

21H 

mov 

tick_vect,bx 

mov 

tick_vect+2*es 

mov 

ax*2500HHNTR_NUMB 

mov 

dx, offset load base 

i nt 

21H 

mov 

ax*1501H 

i nt 

61H 

pop 

es 

pop 

bp 

pop 

di 

pop 

si 

pop 

dx 

pop 

cx 

mov 

ss*stak_save 

mov 

sp*stak_save+2 

pop 

ds 

pop 

bx 

pop 

ax 

ret 


endp 



; Preserve OS 
;Set up Source 

:Set up destination 

: Bytes to copy 
jinitialise flag 
:Copy TSR to RAM 

: Restore OS 

set it to the ISR 

jGet current Int ICH 

: Preserve vector 

;Set interrupt vector 

;Generate Confidence BEEP 
:Restore registers 

: Restore Caller STACK 
; Restore remaining regs 

: FAR return to cal ler 


; Interrupt Service Routine (ISR) 


equ 

64H 

: Peripheral PIO code 

equ 

807fH 

:LEOs I/O address 

label 

byte 

;TSR code 

push 

ax 

: Preserve registers 

push 

dx 

push 

bx 


push 

ds 


push 

es 


mov 

ah*laH 

:Get Peripheral PID 

int 

61H 

or 

al *al 

[Peripheral installed? 

Sz 

ticknone 

;No, so uninstall 

emp 

ah*PID_CODE 

[Correct peripheral? 

jne 

tick_none 

[No* so uninstall 


; Peripheral installed* so toggle LEDs 


my dx*LEDS_PORT : Toggle LED address 
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out 

dx,al 


;AL unimportant 


jmp 

short ti ck_exi t 


;Exit 

tick none: 





assunie 

cs:dseg 


: Force DSEG offset 


; Invalid Peripheral, so 

uninstall TSR 


RK)V 

ax,Z500H+IWTR NUMB 

;Set interrupt vector 


nx>v 

bx, offset tick_ 

vect 

;Get old vector 


mov 

ds, cs: [bx+2] 




mov 

dx,cs: [bx] 




int 

ZIH 




:Now vector reset, free 

allocated memory 


push 

cs 


; Segment of block 


pop 

es 




mov 

ah,49H 


jFree memory 


int 

21H 



tickexi t : 

pop 

es 


: Restore registers 


pop 

ds 




pop 

dx 




pop 

bx 




pop 

ax 




jmp 

dword ptr cs:tick vect 

;Jump to old TSR 

C0DE_SIZE 

equ 

$-tick_code 


jSize of I SR 

cseg 

ends 





;Data segment TEMPLATE 

(No initialised data here!) 

dseg 

segment 




datasptr 

label 

byte 


: Start of Data 

staksave 

dw 

7 


; Caller stack stored here 


dw 

? 



tick vect 

dw 

? 


;01d vector stored here 


dw 

7 



loadbase 

label 

byte 


; Start of I SR 

LOAD SIZE 

equ 

($-data sptrl+CODE SUE 

:Load nrodule size 

AL0C_SIZE 

equ 

LOAD_SUE+100H 


;Load module + Stack 

dseg 

ends 





end 

xroni main 
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*^**T(f**** ************************************* ***************** 


Module: XROM.ASM 

Copyright: DIP Ltd, 1989 

ROM Extension DEMO program 


A ROM extension may be run frcxii a Credit Card Memory 
or an Extension ROM. 

The Extension code must preserve ALL registers! 

The Pre-BIOS vector MUST return by a FAR JMP to 
0FFFE:0, as no stack is set up at this stage 

*************************************************************** 


name 

XROM 




assume 

cs:cseg 


IF 

equ 

OaH 

;Line feed 

CR 

equ 

OdH 

: Carriage return 

BIOX 

equ 

OaaSSH 

:Specific BIOS extension 

DOSX 

equ 

055aaH 

: Specific DOS extension 

BIDO 

equ 

055S5H 

: Complete control 

cseg 

segment 




org 

OH 

; Extension Vector table 

xrom main 

label 

near 


bi xttype 

dw 

BlOX 

; Identification code 

bixt si ze 

db 

0 

:Num 512 byte blocks in ROM 


org 

3H 


bixtgbio 

label 

byte 

: Specific BIOS extension 

bixtgdos 

label 

byte 

;Specific DOS extension 


jnip 

genx_vect 

;Specific extension vector 

bixtuser 

org 

40H 


label 

byte 

:0EM user text 


db 

^Test ROM (C) DIP’ 


bixtpreb: 

org 

50H 


jmp 

prebvect 

: Pre-bios jmp vector 

bi xtbext : 

org 

55H 


jmp 

bext_vect 

; Bios -ext jfiip vector 

bixt pdos: 

org 

5aH 


jmp 

pdos_vect 

;Pre-dos jmp vector 


org 

5fH 


bixtdext: 

jmp 

dextvect 

;Dos-ext jmp vector 

bi xt ados: 

org 

64H 


jmp 

ados_vect 

jPost-dos Jmp vector 

bixtpwdn: 

org 

69H 


jmp 

pwdn vect 

: Power down jmp vector 

bixt__pwup: 

org 

6eH 


jmp 

pwupvect 

: Power up jmp vector 

xrom^proc 

proc 

FAR 



;Determine extension type 


genx^vect 

label 

near 
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: Preserve BP 



push 


cmp 

jne 

notgenb: 

mov 

jmp 

cmp 

jne 

notgend; 

mov 

jmp 

mov 

jmp 

preb vect 

label 


jmp 

prebretn 

dw 

dw 

bextvect 

label 


push 

mov 

jmp 

pdos_vect 

label 


push 

mov 

jmp 

dext_vect 

label 


push 

mov 

jmp 

adosvect 

label 


push 

mov 

jmp 

pwdn_vect 

label 


push 

mov 

jmp 

pwup vect 

label 


push 

mov 

jmp 

xrom disp 

label 


push 

push 

push 

push 

push 


call 


mov 

int 


or 


bp 

cs:[0],BI0X 

notgenb 

bp, offset gbiotext 
short xrom_disp 

cs:[0],D0SX 

notgend 

bp, offset gdos_text 
short xroni disp 

bp, offset invl_text 
short xrom^disp 


near 

dword ptr cs:preb_retn 
0 

OfffeH 

near 

bp 

bp, offset bexttext 
short xrom disp 

near 

bp 

bp, oft set pdos_text 
short xrom_disp 

near 

bp 

bp, offset dexttext 
short xrom dtsp 

near 

bp 

bp, off set adostext 
short xroni disp 

near 

bp 

bp, offset pwdntext 
short xron^ disp 

near 

bp 

bp, offset pwuptext 
short xrom^disp 

near 

ax 

bx 

cx 

dx 

es 

di sptext 

ax,2400H 

61H 

dl,dl 


rSpecific BIOS extension 
:No 

^Specific BIOS extn text 


rSpecific DOS extension 
:No 

iSpecific DOS extn text 


; Inval id text 


:Pre-BI0S extension 


: Post-BIOS extension 


: Pre-DOS extension 


:D0S extension 


: Post-DOS extension 


: Power-Down extension 


: Power-Up extension 


jMain display routine 
I Preserve registers 


jDisplay text in BP 
;Get ROM state 


: Normal ROM ? 


not norm: 


not ctrva: 


not drvb: 


not_xrom: 

stdtdisp: 


xromproc 


jnz 

notnorm 

;Ho, so skip 

mov 

bp, offset norm^text 

;Get normal ROM text 

jmp 

short stat di sp 


dec 

dl 

: Drive A ? 

jnz 

not drva 

;No, so skip 

mov 

bp, offset drva text 

;Get Drive A text 

jnip 

short stat disp 


dec 

dl 

;0riue B ? 

jnz 

notdrvb 

;No, so skip 

mov 

bp, offset drvb_text 

;Get Drive B text 

jmp 

short stat_disp 


dec 

dl 

rDrive B ? 

jnz 

notxrom 

:No, so skip 

mov 

bp, off set xrom text 

;Get Drive B text 

jmp 

short stat_disp 


mov 

bp, offset invltext 


cal 1 

di sp_text 

rDisplay text in BP 

nx)v 

bp, off set crlftext 

^Finally CR, LF 

cal 1 

di sptext 

pop 

es 

; Restore registers 

pop 

dx 

pop 

cx 


pop 

bx 


pop 

ax 


pop 

bp 


ret 


:FAR return 

endp 




***************** *************** ******^*****^ 1 ^*^*^^^*^**^^*^^*^^ 
Main Display routine 

***********!*; irk -kirirk-k-k-klcififkititie^Tltifkiriri^ ail; tiiitirifkie it ******** *f** it ic *****: 


di sp_text 

proc 


xor 


mov 


int 


push 


pop 


xor 


mov 


inc 


mov 


i nt 


ret 

di sp text 

endp 

gbio_text 

db 


db 

gdostext 

db 


db 

bexttext 

db 


db 


near 

bh,bh 
ah, 3 
lOH 

cs 

es 

ch,ch 

cl,es:[bp] 

bp 

ax,1301H 

lOH 


gdos_text-$-l 

'Spec BIOS Extension - 

bext_text‘$-l 

'Spec DOS Extension - 

pdos text-$-l 

'Com BIOS Extension - ' 
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:Page 0 

;Get cursor position in DX 


; Access text 


: Initial i se 
:Get length 
; Advance to text 

: Write string 


pdos_text 

db 


db 

dext text 

db 


db 

ados_text 

db 


db 

pwdn_text 

db 


db 

pwuptext 

db 


db 

norm_text 

db 


db 

drvatext 

db 


db 

drvb text 

db 


db 

xrom text 

db 


db 

invltext 

db 


db 

crl f text 

db 

cseg 

ends 


end 


dext_text-$-l 
'Pre-DOS Extension - 

ddos_text-$-l 

'Com DOS Extension - 

pwdn_text-$-l 
■ Post-DOS Extension - 

pwup_text-$-l 
'Power Down Extension 

norm_text-$-l 
■power Up Extension - 

drva_text-S-l 
'Normal ROM' 

drvb_text-$-l 
'CCH Drive A' 

xrom_text-$-l 
'CCH Drive B’ 

invl_text-$~l 
^Extn ROM' 

crl f text-$-l 
' Inval id ' 

2,CR,LF 


xroni main 
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